hyb-oa/issues/2026-05-26_09-02-34-trellis-primary-development-workflow-v1.csv

1	ID	Title	Description	Acceptance	Test_Method	Tools	Dev_Status	Review1_Status	Regression_Status	Files	Dependencies	Notes
2	TRELLIS1-0	Trellis-first 迁移合同	建立 Trellis 主导开发流程迁移执行合同；本轮只迁移开发协作体系，不改后端/前端业务代码、不部署、不写公网数据。	Issue CSV 符合项目必填列；范围明确为 Trellis-first workflow/spec/task/governance；保留 Issue CSV 审计合同和 docs 业务事实源。	受影响流程：需求进入 -> Trellis task/spec/workflow -> Issue CSV 审计合同 -> 实施/验证/复盘；验证步骤：validate_issues_csv；check-process-contract baseline；git diff --check。	python3|node|manual	DONE	DONE	DONE	issues/2026-05-26_09-02-34-trellis-primary-development-workflow-v1.csv	[]	回滚路径：删除本合同后续引入的 .trellis、治理脚本和文档/AGENTS 改动，恢复旧 AGENTS.md；不影响业务运行。
3	TRELLIS1-1	Trellis CLI 隔离确认	确认 Trellis CLI 是否可用；只在 /tmp/hyb-oa-trellis-pilot 隔离目录初始化，记录版本、命令和生成文件清单，不直接覆盖主仓。	能得到 trellis 版本或记录无法安装/执行的外部环境原因；隔离初始化结果只写 /tmp；主仓没有被 CLI 直接修改。	受影响流程：工具确认 -> /tmp 隔离初始化 -> 生成文件清单 -> 冲突判断；验证步骤：trellis --version；在 /tmp 运行初始化；git status --short 确认主仓仅预期改动。	trellis|git|manual	DONE	DONE	DONE	external;/tmp/hyb-oa-trellis-pilot	["TRELLIS1-0"]	已确认官方包 @mindfoldhq/trellis 0.5.19；/tmp 隔离 init 使用 --codex --skip-existing --no-monorepo --yes，生成 .trellis、.codex 和 trellis-* skills，跳过现有 AGENTS.md。
4	TRELLIS1-2	Trellis 生成物冲突分析	比较隔离初始化生成物与现有 AGENTS.md、.agents/skills、.codex 和 Issue CSV 流程的冲突；明确只采纳最小安全子集。	形成冲突结论；不得让 Trellis 自动覆盖现有硬约束；明确 AGENTS.md、skill、Issue CSV 的保留/迁移边界。	受影响流程：生成文件清单 -> 与主仓现有协作文件比对 -> 采纳/暂缓/拒绝；验证步骤：find /tmp/hyb-oa-trellis-pilot；diff/rg 只读比对；回填 Notes。	git|rg|manual	DONE	DONE	DONE	.trellis;AGENTS.md;.agents/skills/hyb-oa-delivery/SKILL.md;.codex	["TRELLIS1-1"]	Trellis 可以主导流程，但 Issue CSV 仍是审计合同，docs 仍是业务事实源；不启用自动 commit 或高风险 hooks。
5	TRELLIS1-3	主仓最小 .trellis 结构	在主仓建立最小 .trellis/workflow.md、.trellis/spec 和 .trellis/tasks；后续新需求默认从 Trellis task 开始。	workflow 能指引开发入口；spec 覆盖治理、后端、前端设计、审批、报销/OCR、企微、部署、文档证据、隐私安全；tasks 有首个低风险试点任务并引用本 Issue CSV。	受影响流程：新需求进入 -> 读取 workflow -> 选 spec -> 创建 task -> 绑定 Issue CSV；验证步骤：node scripts/qa/check-trellis-governance.mjs。	manual|node	DONE	DONE	DONE	.trellis/workflow.md;.trellis/spec;.trellis/tasks	["TRELLIS1-2"]	主仓 .trellis 只放脱敏规则、任务和复盘；不得保存密码、token、Secret、真实票据、合同正文、银行资料、完整账号或完整本地路径。回滚路径：删除本行新增的 .trellis workflow/spec/tasks 后恢复 AGENTS 旧入口；清理不影响业务代码。
6	TRELLIS1-4	稳定交付规则迁入 Trellis spec	从 AGENTS.md、Agent 开发交付实践和项目 skill 中提炼长期稳定规则，写入 Trellis specs；skill 保留高频操作入口和当前事实提示。	spec 能覆盖后续开发所需硬规则；skill 不再作为唯一长上下文来源；没有丢失 Issue CSV、文档复用、隐私、部署、企微边界。	受影响流程：规则读取 -> spec 分类 -> skill 保留入口 -> 后续按领域读取；验证步骤：rg TRELLIS1/.trellis；quick_validate skill。	rg|manual|python3	DONE	DONE	DONE	.trellis/spec;.agents/skills/hyb-oa-delivery/SKILL.md;docs/Agent开发交付实践.md	["TRELLIS1-3"]	不搬运过期历史长段落到 spec；历史证据仍通过 docs/Issue/artifacts 追溯。回滚路径：删除或 supersede 对应 Trellis spec，继续按 docs/Skill 原入口执行；清理不影响业务代码。
7	TRELLIS1-5	AGENTS.md 改造为 Trellis-first 入口	将 AGENTS.md 从长流程说明改成 Trellis-first 导航和硬约束入口；开发先读 .trellis/workflow.md，再按任务读取 specs 和 Issue CSV。	AGENTS.md 明确 Trellis 为主流程、Issue CSV 为审计合同、docs 为业务事实源；保留编码前方案、非微小改动先有 Issue CSV、中文沟通、隐私和部署边界。	受影响流程：Codex 启动 -> AGENTS.md -> .trellis/workflow.md -> task/spec/Issue；验证步骤：node scripts/qa/check-trellis-governance.mjs；git diff --check。	manual|node|git	DONE	DONE	DONE	AGENTS.md;.trellis/workflow.md	["TRELLIS1-4"]	回滚路径：git 恢复旧 AGENTS.md；不影响业务代码。
8	TRELLIS1-6	Trellis 治理检查脚本	新增 QA-only 脚本检查 Trellis task 绑定、敏感信息、AGENTS 指针、文档登记和 spec 最小集合。	脚本 node --check 通过；运行后能发现缺 Issue CSV、缺 workflow 指针、缺文档登记或敏感信息；不读取外部网络、不写业务数据。	受影响流程：开发前/提交前 -> Trellis governance gate -> 敏感信息与登记检查；验证步骤：node --check scripts/qa/check-trellis-governance.mjs；node scripts/qa/check-trellis-governance.mjs。	node|rg	DONE	DONE	DONE	scripts/qa/check-trellis-governance.mjs;.trellis	["TRELLIS1-3","TRELLIS1-5"]	敏感扫描采用保守模式，命中疑似 token/Secret/密码/票据正文/完整账号/完整本地路径时失败；必要时用脱敏占位重写。
9	TRELLIS1-7	低风险任务试跑闭环	创建一个低风险 Trellis task，模拟后续需求从 task 进入、绑定 Issue CSV、验证、复盘；不改业务代码。	试点 task 包含目标、Issue CSV、涉及 spec、验收命令和复盘；治理脚本通过；后续开发入口已可按 Trellis-first 运行。	受影响流程：Trellis task -> Issue CSV -> 验证命令 -> 复盘记录；验证步骤：node scripts/qa/check-trellis-governance.mjs；rg TRELLIS1。	node|rg|manual	DONE	DONE	DONE	.trellis/tasks/05-26-trellis1-pilot	["TRELLIS1-6"]	试点任务仅用于流程验证；已绑定 TRELLIS1-7、implement/check jsonl 和 prd；不触发部署、不写公网、不改变业务行为。
10	TRELLIS1-8	文档回写、门禁和提交	更新 Agent 开发交付实践、文档索引、事实源矩阵和 skill；执行合同/文档/脚本门禁并提交中文 commit。	validate_issues_csv、check-process-contract baseline、audit-docs、quick_validate、check-trellis-governance、git diff --check 和 check-minimal 通过或阻断可解释；提交中文 commit 引用 TRELLIS1。	受影响流程：事实源回写 -> 门禁 -> commit -> 后续 Trellis-first 使用；验证步骤：validate_issues_csv；check-process-contract；audit-docs；quick_validate；node check-trellis-governance；git diff --check；bash scripts/check-minimal.sh。	python3|node|bash|git	DONE	DONE	DONE	docs/Agent开发交付实践.md;docs/文档索引.md;docs/文档事实源状态矩阵.md;.agents/skills/hyb-oa-delivery/SKILL.md	["TRELLIS1-7"]	门禁通过：validate_issues_csv、check-process-contract baseline/docs-only、audit-docs registry、quick_validate、check-trellis-governance、git diff --check、check-minimal；本轮不部署，面向用户可测试的业务行为无变化。