wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 8 软件包 项目 发布 百科 活动

TRELLIS1 迁移 Trellis 主导开发流程

浏览代码
这个提交包含在：
wangsli
2026-05-26 09:28:51 +08:00
父节点 7c65d418f3
当前提交 e7baa6c234
共修改 114 个文件，包含 14684 行新增和 178 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
issues/2026-05-26_09-02-34-trellis-primary-development-workflow-v1.csv
+10
查看文件
@@ -0,0 +1,10 @@
"ID","Title","Description","Acceptance","Test_Method","Tools","Dev_Status","Review1_Status","Regression_Status","Files","Dependencies","Notes"
"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；不影响业务运行。"
"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。"
"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。"
"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 旧入口；清理不影响业务代码。"
"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 原入口执行；清理不影响业务代码。"
"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；不影响业务代码。"
"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/密码/票据正文/完整账号/完整本地路径时失败；必要时用脱敏占位重写。"
"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；不触发部署、不写公网、不改变业务行为。"
"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；本轮不部署，面向用户可测试的业务行为无变化。"
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；本轮不部署，面向用户可测试的业务行为无变化。