TRELLIS1 迁移 Trellis 主导开发流程

docs/Agent开发交付实践.md

@@ -10,11 +10,26 @@
 - OpenAI Codex Automations: https://openai.com/academy/codex-automations/
 - OpenAI Agents 文档: https://platform.openai.com/docs/guides/agents
 - OpenAI Evals 文档: https://platform.openai.com/docs/guides/evals
+- Trellis: https://github.com/mindfold-ai/trellis
 - Anthropic Building Effective Agents: https://www.anthropic.com/engineering/building-effective-agents
 - Google Agent Development Kit 文档: https://google.github.io/adk-docs/
 
 ## 本项目采用的原则
 
+### 0. TRELLIS1 后以 Trellis 为主流程
+
+TRELLIS1 起，hyb-oa 的后续非微小开发默认从 `.trellis/tasks/` 进入，由 `.trellis/workflow.md` 组织计划、实施、检查和复盘。
+
+Trellis 的定位是“开发流程和上下文组织层”，不是业务事实源替代品：
+
+- Trellis task：承载本轮需求 PRD、上下文和复盘。
+- Trellis spec：沉淀稳定开发规则和高频工程边界。
+- Issue CSV：仍是执行合同、验收、状态和回滚审计台账。
+- `docs/`：仍是业务事实源、产品规则、操作手册和证据入口。
+- `AGENTS.md`：只保留 Trellis-first 入口和不可违反硬约束。
+
+每个 Trellis task 必须绑定 Issue CSV 和 Issue ID；`.trellis/workspace/` 默认作为本地个人日志，不提交。提交前必须运行 `node scripts/qa/check-trellis-governance.mjs`。
+
 ### 1. 先简单、后编排
 
 默认由主 agent 在当前上下文内完成计划、实现、验证和提交。只有当任务能明确拆分、文件写入范围互不冲突、并且并行能实质缩短关键路径时，才使用子 agent。
@@ -39,7 +54,7 @@ Skill 用于减少重复沟通和降低遗漏风险，适合沉淀：
 - Playwright 视觉巡检要求。
 - 报销、发票、企业微信等高频业务的检查入口。
 
-Skill 不复制长文档。详细规则放在 `docs/`，Skill 通过 references 指向需要时再读取。
+Skill 不复制长文档。详细业务规则放在 `docs/`，稳定开发规则沉淀到 `.trellis/spec/`，Skill 通过 references 指向需要时再读取。
 
 ### 4. 文档保存事实源
 
@@ -52,7 +67,7 @@ Skill 不复制长文档。详细规则放在 `docs/`，Skill 通过 references
 - 试运行手册：`docs/试运行与自动化验证手册.md`
 - Agent 交付实践：`docs/Agent开发交付实践.md`
 
-AGENTS.md 只放硬约束和入口，不复制长规则。
+AGENTS.md 只放 Trellis-first 入口和硬约束，不复制长规则。
 
 ### 5. 工具调用必须可验证