@devcxl/opencode-cabbage 0.2.0 → 0.3.0

package/README.md

@@ -1,14 +1,17 @@
-# @devcxl/opencode-cabbage
-
-全流程开发 OpenCode 插件 — 覆盖需求→设计→任务→编码→测试→审查→发布完整开发生命周期，支持自动编排与并行 Subagent。
-
-[![npm version](https://img.shields.io/npm/v/@devcxl/opencode-cabbage)](https://www.npmjs.com/package/@devcxl/opencode-cabbage)
-[![CI](https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml/badge.svg)](https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml)
-[![GitHub Pages](https://github.com/devcxl/opencode-cabbage/actions/workflows/pages.yml/badge.svg)](https://devcxl.github.io/opencode-cabbage)
+<div align="center">
+  <h1>@devcxl/opencode-cabbage</h1>
+  <p>A full-lifecycle development plugin for OpenCode, covering requirements, design, tasks, coding, testing, review, and release with automated orchestration and parallel subagents.</p>
+  <p>
+    <a href="https://www.npmjs.com/package/@devcxl/opencode-cabbage"><img src="https://img.shields.io/npm/v/@devcxl/opencode-cabbage" alt="npm version"></a>
+    <a href="https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml"><img src="https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+    <a href="https://devcxl.github.io/opencode-cabbage"><img src="https://github.com/devcxl/opencode-cabbage/actions/workflows/pages.yml/badge.svg?branch=main" alt="GitHub Pages"></a>
+  </p>
+  <p>English | <a href="README.zh.md">简体中文</a></p>
+</div>
 
 ---
 
-## 安装
+## Installation
 
 ```json
 // opencode.json
@@ -17,72 +20,72 @@
 }
 ```
 
-插件启动后自动注入 9 个 slash command、9 个 flow skill、5 个 agent。
+Once started, the plugin automatically injects 9 slash commands, 9 flow skills, and 5 agents.
 
-## 命令一览
+## Command Overview
 
-| 命令 | 阶段 | 产出 |
-|------|------|------|
-| `/setup` | 初始化 | docs/ 目录结构、环境验证 |
-| `/requirements` | 需求 | PRD → `docs/prd/` + GitHub Issue |
-| `/design` | 设计 | 技术方案 + ADR → `docs/dev/specs/` + `docs/adr/` |
-| `/tasks` | 任务拆解 | DAG 任务 + Sub Issues → `docs/dev/tasks/` |
-| `/code` | 编码 | 分支 + 代码 + 单测 + PR |
-| `/test` | 测试 | 触发 CI + 监控 + 汇报 |
-| `/review` | 审查 | 双轴审查 + 自动合并 |
-| `/release` | ⚠️ 手动发布 | 版本 → Changelog → Release → npm publish |
-| `/handoff` | 交接 | 打包上下文，跨会话传递 |
+| Command | Stage | Output |
+|---------|-------|--------|
+| `/setup` | Setup | `docs/` directory structure and environment validation |
+| `/requirements` | Requirements | PRD → `docs/prd/` + GitHub Issue |
+| `/design` | Design | Technical specification + ADR → `docs/dev/specs/` + `docs/adr/` |
+| `/tasks` | Task decomposition | DAG tasks + Sub Issues → `docs/dev/tasks/` |
+| `/code` | Coding | Branch + code + unit tests + PR |
+| `/test` | Testing | Trigger CI + monitor + report |
+| `/review` | Review | Dual-axis review + automatic merge |
+| `/release` | ⚠️ Manual release | Version → Changelog → Release → npm publish |
+| `/handoff` | Handoff | Package context for transfer across sessions |
 
-## 快速开始
+## Quick Start
 
 ```bash
-# 1. 安装
+# 1. Install
 npm install @devcxl/opencode-cabbage
 
-# 2. 在 opencode.json 中添加
+# 2. Add the plugin to opencode.json
 # { "plugin": ["@devcxl/opencode-cabbage"] }
 
-# 3. 在 OpenCode 中执行
+# 3. Run in OpenCode
 # /setup → /requirements → @dev-lifecycle
 ```
 
-## 两种模式
+## Two Modes
 
-- **手动模式** — 按顺序逐一执行命令，适合精细控制
-- **自动模式** — 需求确认后输入 `@dev-lifecycle`，全自动完成剩余流程
+- **Manual mode** — Run each command sequentially for fine-grained control
+- **Automatic mode** — Once the requirements are confirmed, enter `@dev-lifecycle` to automatically complete the remaining workflow
 
-## 架构
+## Architecture
 
 ```
-src/                          # TypeScript 薄层
-├── index.ts                  # 插件入口
-├── plugin.ts                 # 包路径解析
+src/                          # Thin TypeScript layer
+├── index.ts                  # Plugin entry point
+├── plugin.ts                 # Package root resolution
 └── plugin/
-    ├── server.ts             # 主工厂：注入 skills/commands/agents
-    ├── commands.ts           # Command 加载器
-    ├── skills.ts             # Skill 加载器
-    ├── prompts.ts            # Prompt 加载器
-    ├── bootstrap.ts          # 启动引导
-    └── agents.ts             # Agent 注入
-
-assets/                       # 运行时资源
-├── commands/                 # 9 个 slash command
-├── skills/                   # 9 个 flow-* skill
-├── agents/                   # 5 个 agent 定义
-├── context/                  # 领域词汇表
-└── prompts/                  # 引导提示词 + 模板
+    ├── server.ts             # Main factory: injects skills, commands, and agents
+    ├── commands.ts           # Command loader
+    ├── skills.ts             # Skill loader
+    ├── prompts.ts            # Prompt loader
+    ├── bootstrap.ts          # Startup guidance
+    └── agents.ts             # Agent injection
+
+assets/                       # Runtime assets
+├── commands/                 # 9 slash commands
+├── skills/                   # 9 flow-* skills
+├── agents/                   # 5 agent definitions
+├── context/                  # Domain glossary
+└── prompts/                  # Guidance prompts and templates
 ```
 
-## 文档
+## Documentation
 
-| 文档 | 链接 |
-|------|------|
-| 快速开始 | [docs/guides/quickstart.md](docs/guides/quickstart.md) |
-| 配置指南 | [docs/guides/configuration.md](docs/guides/configuration.md) |
-| 使用指南 | [docs/guides/usage.md](docs/guides/usage.md) |
-| 架构概览 | [docs/guides/architecture.md](docs/guides/architecture.md) |
-| 贡献指南 | [docs/dev/guides/contributing.md](docs/dev/guides/contributing.md) |
+| Document | Link |
+|----------|------|
+| Quick Start | [docs/guides/quickstart.md](docs/guides/quickstart.md) |
+| Configuration Guide | [docs/guides/configuration.md](docs/guides/configuration.md) |
+| Usage Guide | [docs/guides/usage.md](docs/guides/usage.md) |
+| Architecture Overview | [docs/guides/architecture.md](docs/guides/architecture.md) |
+| Contributing Guide | [docs/dev/guides/contributing.md](docs/dev/guides/contributing.md) |
 
-## 许可
+## License
 
 MIT

package/README.zh.md

@@ -0,0 +1,91 @@
+<div align="center">
+  <h1>@devcxl/opencode-cabbage</h1>
+  <p>全流程开发 OpenCode 插件 — 覆盖需求、设计、任务、编码、测试、审查和发布完整开发生命周期，支持自动编排与并行 Subagent。</p>
+  <p>
+    <a href="https://www.npmjs.com/package/@devcxl/opencode-cabbage"><img src="https://img.shields.io/npm/v/@devcxl/opencode-cabbage" alt="npm version"></a>
+    <a href="https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml"><img src="https://github.com/devcxl/opencode-cabbage/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+    <a href="https://devcxl.github.io/opencode-cabbage"><img src="https://github.com/devcxl/opencode-cabbage/actions/workflows/pages.yml/badge.svg?branch=main" alt="GitHub Pages"></a>
+  </p>
+  <p><a href="README.md">English</a> | 简体中文</p>
+</div>
+
+---
+
+## 安装
+
+```json
+// opencode.json
+{
+  "plugin": ["@devcxl/opencode-cabbage"]
+}
+```
+
+插件启动后自动注入 9 个 slash command、9 个 flow skill、5 个 agent。
+
+## 命令一览
+
+| 命令 | 阶段 | 产出 |
+|------|------|------|
+| `/setup` | 初始化 | `docs/` 目录结构、环境验证 |
+| `/requirements` | 需求 | PRD → `docs/prd/` + GitHub Issue |
+| `/design` | 设计 | 技术方案 + ADR → `docs/dev/specs/` + `docs/adr/` |
+| `/tasks` | 任务拆解 | DAG 任务 + Sub Issues → `docs/dev/tasks/` |
+| `/code` | 编码 | 分支 + 代码 + 单测 + PR |
+| `/test` | 测试 | 触发 CI + 监控 + 汇报 |
+| `/review` | 审查 | 双轴审查 + 自动合并 |
+| `/release` | ⚠️ 手动发布 | 版本 → Changelog → Release → npm publish |
+| `/handoff` | 交接 | 打包上下文，跨会话传递 |
+
+## 快速开始
+
+```bash
+# 1. 安装
+npm install @devcxl/opencode-cabbage
+
+# 2. 在 opencode.json 中添加
+# { "plugin": ["@devcxl/opencode-cabbage"] }
+
+# 3. 在 OpenCode 中执行
+# /setup → /requirements → @dev-lifecycle
+```
+
+## 两种模式
+
+- **手动模式** — 按顺序逐一执行命令，适合精细控制
+- **自动模式** — 需求确认后输入 `@dev-lifecycle`，全自动完成剩余流程
+
+## 架构
+
+```
+src/                          # TypeScript 薄层
+├── index.ts                  # 插件入口
+├── plugin.ts                 # 包路径解析
+└── plugin/
+    ├── server.ts             # 主工厂：注入 skills/commands/agents
+    ├── commands.ts           # Command 加载器
+    ├── skills.ts             # Skill 加载器
+    ├── prompts.ts            # Prompt 加载器
+    ├── bootstrap.ts          # 启动引导
+    └── agents.ts             # Agent 注入
+
+assets/                       # 运行时资源
+├── commands/                 # 9 个 slash command
+├── skills/                   # 9 个 flow-* skill
+├── agents/                   # 5 个 agent 定义
+├── context/                  # 领域词汇表
+└── prompts/                  # 引导提示词 + 模板
+```
+
+## 文档
+
+| 文档 | 链接 |
+|------|------|
+| 快速开始 | [docs/guides/quickstart.md](docs/guides/quickstart.md) |
+| 配置指南 | [docs/guides/configuration.md](docs/guides/configuration.md) |
+| 使用指南 | [docs/guides/usage.md](docs/guides/usage.md) |
+| 架构概览 | [docs/guides/architecture.md](docs/guides/architecture.md) |
+| 贡献指南 | [docs/dev/guides/contributing.md](docs/dev/guides/contributing.md) |
+
+## 许可
+
+MIT

package/assets/agents/dev-lifecycle.md

@@ -13,6 +13,8 @@ color: '#00bcd4'
 使用 `goal` 工具管理 flow 状态。Plugin 会在你每次 idle 时自动注入 continuation prompt，你只需做好当前 step 即可。
 
 无需用户逐步骤确认，仅在遇到非预期错误时暂停并告知。
+
+**TDD 约束**：编码阶段引用 `flow-tdd` skill 作为 TDD 协议唯一来源。
 </system-reminder>
 
 ## 开始工作
@@ -20,13 +22,13 @@ color: '#00bcd4'
 1. 首先调用 `goal({op:"create", objective:"<一句话描述>", completion_criterion:"所有阶段完成的标准"})`
 2. 然后按下方 Phase 顺序执行
 3. 每个阶段完成后，Plugin 会自动 continuation，进入下一阶段
-4. 最终全部完成后调用 `goal({op:"complete"})` → 会被 BLOCKED，按指示操作
+4. 最终全部完成后，直接使用 Task 工具派发 `@goal-verify` 做独立验证
 
 ## 调度团队
 
 - @architect：技术方案、ADR、DAG 任务拆解
-- @backend：后端代码 TDD 实现（编码 + 测试 + commit + push，不创建 PR）
-- @frontend：前端代码 TDD 实现（编码 + 测试 + commit + push，不创建 PR）
+- @backend：后端代码 TDD 实现（加载 `flow-tdd` skill，遵循 RED→GREEN cycle，编码 + 测试 + commit + push，不创建 PR）
+- @frontend：前端代码 TDD 实现（加载 `flow-tdd` skill，遵循 RED→GREEN cycle，编码 + 测试 + commit + push，不创建 PR）
 - @reviewer：只读代码审查，输出结构化审查报告（不操作 git/GitHub，不写文件）
 - @goal-verify：独立验证 Goal 完成状态（**只有它可以调用 goal({op:"complete"})**）
 
@@ -87,19 +89,22 @@ For each batch:
        - 不存在 → git worktree add -b feat/<task-slug> .worktree/<task-slug> $BASE
        - 存在 → 验证分支一致，一致则复用，不一致则报错
     2. 并行派发 @backend/@frontend 到各 worktree 路径
-    3. 每个 agent 在 worktree 内（不创建 PR）:
-       - npm install（如未安装）
-       - 编码 + 单测
-       - commit + push
-       - 返回 branch、commit、test result
-    4. 编排器（你）为每个完成的 task 创建 PR：
-       gh pr create --title "<title>" --body "Closes #<issue-num>"
-    5. 等待 batch 内所有 PR 就绪
-    6. 委派 @reviewer 审查各 PR，接收结构化审查报告
-    7. 编排器发布审查结果：
-       gh pr review <pr-number> --approve|--request-changes --body "<报告>"
-    8. CI 通过后合并 PR
-    9. 合并后清理 worktree
+     3. 每个 agent 在 worktree 内（不创建 PR）:
+        - npm install（如未安装）
+        - 加载 `flow-tdd` skill，遵循 TDD Advisory Protocol
+        - 编码 + 单测（RED→GREEN cycle + final-regression + final-verification）
+        - commit + push
+        - 返回 branch、commit SHA、TDD self-report、test summary
+     4. 编排器（你）通过 broker tools 为每个完成的 task 创建 PR：
+        不直接执行 `gh pr create`，而是使用 Plugin 提供的 broker 接口
+        （如 `flow_pr create` 命令），由 broker 在隔离凭证下执行 GitHub 写操作
+     5. 等待 batch 内所有 PR 就绪
+     6. 委派 @reviewer 审查各 PR，接收结构化审查报告
+     7. 编排器通过 broker tools 发布审查结果：
+        不直接执行 `gh pr review`，使用 `flow_pr review` 命令
+     8. CI 通过后通过 broker tools 合并 PR：
+        不直接执行 `gh pr merge`，使用 `flow_pr merge` 命令
+     9. 合并后清理 worktree
 
 串行 task（有依赖关系）使用清理后重建策略：
   上一 task 合并 → git worktree remove → git worktree add 新 task
@@ -118,19 +123,20 @@ For each batch:
 确认全部 task PR 已合并：
 1. 检查关联 PR 合并状态
 2. 确认所有 Sub Issues 已自动关闭
-3. 关闭 Parent Issue：
-   ```bash
-   gh issue close <parent-number> --comment "已完成。全部 Sub Issue 已通过 PR 合并关闭。"
-   ```
+ 3. 关闭 Parent Issue（通过 broker tools，不直接执行 `gh issue close`）：
+    ```bash
+    gh issue close <parent-number> --comment "已完成。全部 Sub Issue 已通过 PR 合并关闭。"
+    ```
+    注：此处的 `gh issue close` 由 broker tools 在隔离凭证下执行，编排器不直接调用。
 4. 确认 FlowRun 无阻塞任务
 
 ---
 
 ## 完成
 
-所有阶段完成后，调用 `goal({op:"complete"})`。
+所有阶段完成后，直接使用 Task 工具派发 `@goal-verify` 子 agent 做独立验证。
 
-**如果被 BLOCKED：** 使用 Task 工具派发 `@goal-verify` 子 agent 做独立验证。**只有 goal-verify 可以完成 Goal**。
+无需先调用 `goal({op:"complete"})`。主会话不能自行完成 Goal，只有 goal-verify 验证通过后可以完成。
 
 ---
 

package/assets/agents/team/architect.md

@@ -8,6 +8,20 @@ tools:
   bash: true
   write: true
   edit: true
+permission:
+  bash:
+    "*": "deny"
+    "npm *": "allow"
+    "git status": "allow"
+    "git status *": "allow"
+    "git diff": "allow"
+    "git diff *": "allow"
+    "git log": "allow"
+    "git log *": "allow"
+  edit:
+    "*": "deny"
+    "docs/**": "allow"
+    "assets/**": "allow"
 ---
 
 <system-reminder>

package/assets/agents/team/backend.md

@@ -16,12 +16,26 @@ capabilities:
   push_branch: true
   approve_review: false
   complete_goal: false
+permission:
+  bash:
+    "*": "deny"
+    "npm *": "allow"
+    "git *": "allow"
+  edit:
+    "*": "deny"
+    ".worktree/**": "allow"
+    "src/**": "allow"
+    "test/**": "allow"
+    "assets/**": "allow"
 ---
 
 <system-reminder>
 你是团队中的 @backend，负责后端代码实现。
 
 你接收 @architect 的技术方案，按任务逐一实现后端功能。
+
+**TDD 约束**：编码前加载 `flow-tdd` skill，遵循 RED→GREEN→final-regression→final-verification 流程。
+self-report 每个 cycle 的状态，不跳过任何阶段。
 </system-reminder>
 
 ## 工作流程

package/assets/agents/team/frontend.md

@@ -16,12 +16,26 @@ capabilities:
   push_branch: true
   approve_review: false
   complete_goal: false
+permission:
+  bash:
+    "*": "deny"
+    "npm *": "allow"
+    "git *": "allow"
+  edit:
+    "*": "deny"
+    ".worktree/**": "allow"
+    "src/**": "allow"
+    "test/**": "allow"
+    "assets/**": "allow"
 ---
 
 <system-reminder>
 你是团队中的 @frontend，负责前端代码实现。
 
 你接收 @architect 的技术方案，按任务逐一实现前端功能。
+
+**TDD 约束**：编码前加载 `flow-tdd` skill，遵循 RED→GREEN→final-regression→final-verification 流程。
+self-report 每个 cycle 的状态，不跳过任何阶段。
 </system-reminder>
 
 ## 工作流程

package/assets/agents/team/goal-verify.md

@@ -0,0 +1,54 @@
+---
+name: goal-verify
+description: Goal verification agent. Verifies completion independently.
+mode: subagent
+color: '#9c27b0'
+tools:
+  read: true
+  bash: true
+  write: false
+  edit: false
+permission:
+  bash:
+    "*": "deny"
+    "npm *": "allow"
+    "git status": "allow"
+    "git status *": "allow"
+    "git diff": "allow"
+    "git diff *": "allow"
+    "git log": "allow"
+    "git log *": "allow"
+  edit: "deny"
+---
+
+<system-reminder>
+你是 goal-verify，负责独立验证 Goal 是否已完全达成。
+
+你是唯一有权调用 `goal({op:"complete"})` 的 agent。其他 agent（reviewer、backend、frontend、architect）无权完成 Goal。
+
+你需要从空白上下文开始 — 不假设之前的工作已完成。
+</system-reminder>
+
+## 职责
+
+唯一职责：检查 Goal 是否已完全达成。
+
+先调用 `goal({op:"get"})` 获取 objective 和 completion criterion。
+
+---
+
+## 验证流程
+
+1. 调用 `goal({op:"get"})` 获取 objective 和 completion criterion。
+2. 拆解为具体的、逐项可检查的需求。
+3. 对每个需求收集证据：
+   - 阅读完整文件 — 不只看摘要
+   - 运行测试、构建、lint
+   - 检查 imports、exports、类型是否正确
+4. 每项结论分类：SATISFIED / NOT SATISFIED / UNCERTAIN
+5. 全部 SATISFIED → 调用 `goal({op:"complete"})`
+6. 任何 NOT SATISFIED / UNCERTAIN → 不调用 complete，返回详细报告
+
+---
+
+不创建或修改任何文件。你是只读验证者。

package/assets/agents/team/reviewer.md

@@ -16,6 +16,16 @@ capabilities:
   push_branch: false
   approve_review: false
   complete_goal: false
+permission:
+  bash:
+    "*": "deny"
+    "gh pr view": "allow"
+    "gh pr view *": "allow"
+    "diff": "allow"
+    "diff *": "allow"
+    "gh pr checks": "allow"
+    "gh pr checks *": "allow"
+  edit: "deny"
 ---
 
 <system-reminder>

package/assets/skills/flow-code/SKILL.md

@@ -67,6 +67,19 @@ npm install
 npm test
 ```
 
+#### TDD Advisory Protocol
+
+编码阶段必须遵循 `flow-tdd` skill 定义的 TDD 流程。Agent 在编写任何功能代码前加载 `flow-tdd` skill。
+
+**TDD 检查点（commit 前自检）：**
+- [ ] 每个功能的代码变更都有对应的测试
+- [ ] 测试在修改前是 RED（失败），修改后是 GREEN（通过）
+- [ ] 已完成 `final-regression`（全部测试通过）
+- [ ] 已完成 `final-verification`（对照 acceptance_criteria）
+- [ ] self-report 已写入 commit message 或 PR body
+
+> 引用：`flow-tdd` skill 是 TDD 协议的唯一来源，包含完整的 RED→GREEN cycle 状态机、abandon-cycle 规则和 final-regression/verification 流程。
+
 ### 6. 文档同步检查
 完成编码后，逐项检查以下文档是否需要同步更新：
 

package/assets/skills/flow-review/SKILL.md

@@ -39,6 +39,13 @@ gh pr view <pr-number> --json title,body,files
 对照 PRD（`docs/prd/`）和设计方案（`docs/dev/specs/`）验证。
 - 如发现实现与设计偏差 → 追加到 `docs/dev/changelog/<YYYY-MM-DD-NNN-slug>.md`
 
+**TDD Criterion Coverage** — 检查 Task 的 `acceptance_criteria` 是否被 PR 覆盖：
+- 对照 Task frontmatter 中的 `acceptance` 数组，逐条核查
+- 检查 PR 是否包含每条 criterion 对应的测试或验证
+- 检查 `tdd` 配置块中的 `mode` 和 `min_cycles` 是否被遵循
+- **明确不检查 commit order** — TDD cycle 的 RED→GREEN 顺序是编码过程约束，
+  reviewer 不审查 commit 历史是否呈现 RED-first 模式
+
 ### 5. 合并前检查
 在合并前确认以下项：
 - 文档同步已完成（`docs/guides/` 已更新或无需更新）

package/assets/skills/flow-tasks/SKILL.md

@@ -41,7 +41,39 @@ name: "<task-name>"
 depends_on: ["<前置任务>"]
 labels: ["backend"]
 worktree_root: ".worktree/<task-name>/"
+test_commands:
+  - "npm test -- <test-file>"
+  - "npm run typecheck"
+verify_commands:
+  - "npm run lint"
+tdd:
+  mode: strict
+  min_cycles: 1
+acceptance:
+  - criteria: "<验收标准描述>"
+    verification_type: test | manual | lint
+    test_command: "<关联的测试命令>"
+  - criteria: "<另一条验收标准>"
+    verification_type: test
+    test_command: "npm test -- <other-test>"
 ---
+```
+
+Task frontmatter 新增字段说明：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `test_commands` | `string[]` | TDD cycle 中运行的测试命令列表 |
+| `verify_commands` | `string[]` | final-verification 阶段运行的验证命令 |
+| `tdd.mode` | `"strict" \| "advisory"` | TDD 模式，默认 `strict` |
+| `tdd.min_cycles` | `number` | 最少 RED→GREEN cycle 数量，默认 `1` |
+| `acceptance` | `object[]` | 结构化验收标准列表 |
+| `acceptance[].criteria` | `string` | 验收标准描述 |
+| `acceptance[].verification_type` | `"test" \| "manual" \| "lint"` | 验证方式 |
+| `acceptance[].test_command` | `string` | 关联的测试命令（verification_type 为 test 时必填） |
+
+`tdd` 配置块为 `flow-tdd` skill 提供运行时参数。模式默认 `strict`，
+表示 Agent 必须遵循 RED→GREEN→final-regression→final-verification 完整流程。
 
 ## 目标
 
@@ -49,6 +81,16 @@ worktree_root: ".worktree/<task-name>/"
 
 ## 验收标准
 
+验收标准以结构化 `acceptance` 数组形式定义在 frontmatter 中（见上方模板）。
+每条标准包含 `criteria`（描述）、`verification_type`（验证方式）和 `test_command`（关联命令）。
+`flow-tdd` skill 在 final-verification 阶段逐条核验这些标准。
+
+## TDD 集成
+
+本 skill 生成的 `test_commands`、`verify_commands`、`tdd` 配置块和 `acceptance_criteria`
+是 `flow-tdd` skill 的输入。`flow-tdd` 根据这些字段执行 RED→GREEN cycle、
+final-regression 和 final-verification。
+
 ## Worktree
 - 路径: `.worktree/<task-name>/`
 - 分支: `feat/<task-name>`