trellis2-official-task-contract 采用官方 Trellis 执行合同

AGENTS.md

@@ -1,23 +1,24 @@
 # AGENTS
 
-> Purpose: 以 Trellis 为主流程，保留 Issue CSV 审计合同和 hyb-oa 业务事实源。
+> Purpose: 以官方 Trellis task 为执行合同，驱动 hyb-oa 后续开发、验证和复盘。
 
 ## Trellis-first 入口
 
 - 开始任何非微小开发、审查、测试或文档治理任务前，先读 `.trellis/workflow.md`。
-- Trellis task 是后续需求拆解、上下文组织、执行复盘的主入口；每个 task 必须绑定 `issues/*.csv` 中的 Issue ID。
-- `issues/*.csv` 仍是可审计执行合同；Trellis 不替代 Issue CSV 状态、验收、回滚和 commit 追踪。
-- `docs/` 仍是业务事实源；Trellis spec 只沉淀开发流程和高频工程规则。
+- Trellis task 是后续需求拆解、执行、验证和复盘的执行合同；新任务不再强制绑定 `issues/*.csv`。
+- `prd.md` 是任务需求和验收入口；复杂任务补 `design.md` 或 `implement.md`；`implement.jsonl` / `check.jsonl` 只登记稳定 spec 或 research 上下文。
+- `issues/*.csv` 保留为历史审计材料或特殊外部交付导出格式，不再作为新开发的默认前置合同。
+- `docs/` 仍是业务事实源；Trellis spec 沉淀开发流程和高频工程规则。
 
 ## 不可违反约束
 
 - 编码前先方案：非微小改动必须先给实现方案并等待批准。
-- 先有 Issue CSV 再开发：非微小改动必须先落 `issues/*.csv`。
+- 先有 Trellis task 再开发：非微小改动必须先创建或更新 `.trellis/tasks/<task>/`。
 - 计划工具约束：使用 Codex 原生 `update_plan` 做执行清单，不用外部自定义 plan 替代。
 - 项目 Skill 优先：hyb-oa 交付、试运行、视觉复核、报销/OCR/附件、企业微信或部署类任务继续使用 `.agents/skills/hyb-oa-delivery`，再按 Trellis task/spec 组织上下文。
-- 中文沟通；commit message 使用中文并引用 Issue ID。
+- 中文沟通；commit message 使用中文并引用 Trellis task 名称或任务 ID。
 - 不泄露密码、token、Secret、真实票据、合同正文、银行资料、完整账号、完整本地路径或原始 payload。
-- 不轻易新建文档；优先更新现有事实源、模块规约、操作手册、证据文档或连续 Issue CSV。
+- 不轻易新建文档；优先更新现有事实源、模块规约、操作手册、证据文档或当前 Trellis task。
 - 页面调整必须参考 `docs/产品设计规则.md`，并对齐公司主页 `www.hyinda.com` 的品牌风格。
 - 面向用户可测试的改动，只有部署与公网检查通过后才能告知用户可以测试。
 
@@ -42,14 +43,14 @@
 
 ## Trellis 使用边界
 
-- `.trellis/workspace/` 为本地个人日志，默认不提交；需要沉淀的经验应脱敏后写入 `.trellis/spec/`、`docs/` 或 Issue CSV。
+- `.trellis/workspace/` 为本地个人日志，默认不提交；需要沉淀的经验应脱敏后写入 `.trellis/spec/`、`docs/` 或当前 Trellis task。
 - `.trellis/config.yaml` 固定 `session_auto_commit: false`；Trellis 不得自动提交。
 - 当前仅启用 Codex 适配；不把 Cursor/Claude/其他平台迁移作为本轮默认范围。
 - Codex hooks 文件可以存在，但只有用户级配置和 `/hooks` 审核启用后才生效；本项目不把 hook 自动注入作为验收前提。
 
 ## 编排规则
 
-- 默认按 Trellis workflow 执行：task/prd -> Issue CSV -> implement -> check -> spec/docs update -> commit -> finish。
+- 默认按 Trellis workflow 执行：task/prd -> design/implement notes（按需） -> implement -> check -> spec/docs update -> commit -> finish。
 - 涉及权限模型、状态机、workflow、数据迁移、审批规则时，实施后必须启动只读 review，不让 reviewer 改代码。
 - 公网部署、生产配置、真实数据写入、数据库重置、企业微信写入和真实付款必须另行获得明确批准。
-- 若 Trellis 规则与业务文档冲突：最新 Issue CSV > 当前模块规约/PRD > `docs/产品设计规则.md` 和业务规约 > Trellis spec > 历史证据。
+- 若 Trellis 规则与业务文档冲突：当前 Trellis task PRD/设计 > 当前模块规约 > `docs/产品设计规则.md` 和业务规约 > Trellis spec > 历史证据；历史 Issue CSV 只用于追溯。