feat(skills): Stage Contract 迁移（全部 9 个 Skill）(#61)

* feat(skills): Stage Contract 迁移阶段 1 — 需求/设计/任务/初始化

为 flow-setup, flow-requirements, flow-design, flow-tasks 追加统一 Stage Contract：
Trigger, Inputs, Preconditions, Procedure, Outputs, Failure, Idempotency, Prohibited Actions

* feat(skills): Stage Contract 迁移阶段 2 — 编码/测试/审查/发布/交接

为 flow-code, flow-test, flow-review, flow-release, flow-handoff 追加统一 Stage Contract：
Trigger, Inputs, Preconditions, Procedure, Outputs, Failure, Idempotency, Prohibited Actions

Author: devcxl

assets/skills/flow-code/SKILL.md

@@ -123,3 +123,40 @@ gh pr create --title "<title>" --body-file docs/dev/handoff/pr-body.md
 ## 后续
 - **/test** — 触发 CI E2E 测试
 - **/review** — 审查 PR
+
+## Contract
+
+### Trigger
+由 `/code` 命令或 `@dev-lifecycle` Phase 3 触发。
+
+### Inputs
+- Sub Issue 编号（来源：`/tasks` 产出）
+- task 文件 frontmatter 中的 `worktree_root`（来源：task 文件）
+
+### Preconditions
+- `/tasks` 已完成 → Sub Issues 就绪
+- 前置依赖任务已合并
+
+### Procedure
+1. 选择依赖已满足的 Sub Issue
+2. 创建或复用 Worktree（`git worktree add -b`）
+3. 安装依赖 → 编码 + 单测 → commit + push
+4. 编排器创建 PR
+
+### Outputs
+- Worktree 已创建（`.worktree/<task-slug>/`）
+- 代码已推送
+- PR 已创建（Orchestrator 执行）
+
+### Failure
+- Worktree 创建失败 → 检查分支冲突或目录残留
+- 测试失败 → 修复后重试
+
+### Idempotency
+- Worktree 已存在 → 复用
+- 代码已提交 → 追加提交
+
+### Prohibited Actions
+- Worker 不创建 PR、不操作 Issue
+- 不使用 `git add .`
+- 不直接 push 到默认分支

assets/skills/flow-design/SKILL.md

@@ -81,3 +81,39 @@ git checkout $BASE && git pull origin $BASE
 
 ## 后续
 - **/tasks** — 基于设计方案拆解为 DAG 任务
+
+## Contract
+
+### Trigger
+由 `/design` 命令或 `@dev-lifecycle` Phase 1 触发。
+
+### Inputs
+- `docs/prd/<title>.md` — 上游 PRD（来源：requirements 阶段产出）
+- Parent Issue 编号（来源：Goal metadata 或 `/requirements` 阶段产出）
+
+### Preconditions
+- `/requirements` 已完成 → `docs/prd/<title>.md` 存在
+- Parent Issue 存在
+
+### Procedure
+1. 阅读 PRD、已有 ADR、Out of Scope
+2. 输出技术方案到 `docs/dev/specs/<title>.md`
+3. 记录 ADR 到 `docs/adr/<YYYY-MM-DD>-<slug>.md`
+4. 附设计评论到 Parent Issue
+5. 通过 Planning PR 提交文档
+
+### Outputs
+- `docs/dev/specs/<title>.md` — 技术方案
+- `docs/adr/<date>-<slug>.md` — ADR 决议
+
+### Failure
+- ADR 与已有决策冲突 → 记录冲突并标注
+- Planning PR 合并失败 → 通知用户手动处理
+
+### Idempotency
+- 技术方案已存在 → 读取并更新
+- ADR 已存在 → 不重复创建
+
+### Prohibited Actions
+- 不直接 push 到默认分支
+- 不跳过 ADR 兼容性检查

assets/skills/flow-handoff/SKILL.md

@@ -45,3 +45,32 @@ description: 打包上下文，跨会话传递进度
 
 ## Output
 - `docs/dev/handoff-<date>.md`
+
+## Contract
+
+### Trigger
+由 `/handoff` 命令触发。上下文窗口接近极限或需跨会话传递进度时使用。
+
+### Inputs
+- 当前 Goal 状态（来源：Goal metadata）
+
+### Preconditions
+- 存在 Active Goal
+
+### Procedure
+1. 打包当前流程状态（阶段、任务、进度）
+2. 列出已完成和待完成项
+3. 确定下一步骤
+4. 保存到 handoff 文件
+
+### Outputs
+- `docs/dev/handoff-<date>.md` — 交接文件
+
+### Failure
+- 无 Goal → 仅输出当前会话摘要
+
+### Idempotency
+- 同一天多次执行 → 覆盖前一次 handoff
+
+### Prohibited Actions
+- 不修改代码或文档

assets/skills/flow-release/SKILL.md

@@ -48,3 +48,38 @@ GitHub Releases 页面 → 检查 Release 草稿 → 点击 **Publish release**
 
 ## 后续
 无需后续阶段。Flow 完成。
+
+## Contract
+
+### Trigger
+由 `/release` 命令触发。**仅手动触发**，不包含在自动流程中。
+
+### Inputs
+- 版本号类型（patch/minor/major，来源：用户指定）
+
+### Preconditions
+- 所有 PR 已合并
+- 默认分支最新
+- 所有测试通过
+
+### Procedure
+1. 确认版本号
+2. 更新版本（npm version）
+3. 生成 Changelog
+4. 创建 git tag → push → 触发 Release 草稿
+5. 人工审核发布 → npm publish
+
+### Outputs
+- GitHub Release
+- npm 包已发布
+
+### Failure
+- npm publish 失败 → 检查 npm 认证
+- tag 已存在 → 提示版本冲突
+
+### Idempotency
+- 相同版本号 → 阻止
+
+### Prohibited Actions
+- 不在自动模式中执行
+- 不跳过测试直接发布

assets/skills/flow-requirements/SKILL.md

@@ -46,3 +46,37 @@ gh issue create \
 
 ## 下一阶段
 - **/design** — 基于此 PRD 进行技术设计
+
+## Contract
+
+### Trigger
+由 `/requirements` 命令或 `@dev-lifecycle` Phase 0 触发。
+
+### Inputs
+- 用户提供的功能描述（来自消息文本）
+
+### Preconditions
+- `/setup` 已完成（gh CLI 可用，docs 目录就绪）
+
+### Procedure
+1. 按 interview-guide 进行需求访谈
+2. 输出 PRD 到 `docs/prd/<title>.md`
+3. 记录 Out of Scope 到 `docs/dev/out-of-scope.md`
+4. 创建 Parent GitHub Issue
+
+### Outputs
+- `docs/prd/<title>.md` — PRD 文档
+- `docs/dev/out-of-scope.md` — 排除范围记录
+- GitHub Parent Issue
+
+### Failure
+- gh CLI 不可用 → 提示先执行 /setup
+- Issue 创建失败 → 记录错误，不阻塞 PRD 写入
+
+### Idempotency
+- 如果 PRD 文件已存在 → 更新而非覆盖
+- 如果 Parent Issue 已创建 → 追加评论而非重复创建
+
+### Prohibited Actions
+- 不跳过访谈直接输出 PRD
+- 不省略 Out of Scope 记录

assets/skills/flow-review/SKILL.md

@@ -121,3 +121,39 @@ fi
 
 ## 后续
 - **/release** — 发布（如所有 PR 已合并）
+
+## Contract
+
+### Trigger
+由 `/review` 命令或 `@dev-lifecycle` Phase 3 审查步骤触发。
+
+### Inputs
+- PR 编号（来源：`/code` 产出）
+
+### Preconditions
+- `/code` 已完成 → PR 已创建
+
+### Procedure
+1. 获取 PR diff 和元数据
+2. 双轴审查（规范轴 + 规格轴）
+3. 输出结构化审查报告
+4. 编排器发布审查结果
+5. 等待 CI 通过后合并
+6. 关闭关联 Sub Issue
+7. 安全清理 Worktree（Preflight）
+
+### Outputs
+- 结构化审查报告（APPROVED / CHANGES_REQUESTED）
+- PR 已合并（条件满足时）
+
+### Failure
+- Critical/High → Request Changes
+- Worktree 清理失败 → 记录警告，不阻塞
+
+### Idempotency
+- 已合并的 PR → 跳过
+- 已审查的 PR → 更新结论
+
+### Prohibited Actions
+- 不使用默认 --force 清理
+- 不直接执行 gh pr merge（Orchestrator 执行）

assets/skills/flow-setup/SKILL.md

@@ -41,3 +41,35 @@ echo "setup-complete" > .opencode/opencode-cabbage/setup-complete
 - `docs/` 目录已就绪
 - 开发环境已验证
 - 可开始 `/requirements`
+
+## Contract
+
+### Trigger
+由 `/setup` 命令触发。首次使用插件或切换新项目时执行。
+
+### Inputs
+无外部输入。从当前工作目录检测项目状态。
+
+### Preconditions
+无。不要求任何前置阶段。
+
+### Procedure
+1. 创建 docs 目录结构
+2. 验证 gh CLI 和 GitHub 远程
+3. 写入完成标记
+
+### Outputs
+- `docs/` 目录树（prd, adr, dev/specs, dev/tasks, dev/api, dev/db, dev/guides, dev/handoff）
+- `.opencode/opencode-cabbage/setup-complete` 标记文件
+
+### Failure
+- 目录创建失败 → 报告错误并退出
+- gh auth 失败 → 提示用户执行 `gh auth login`
+
+### Idempotency
+- 已存在的目录跳过
+- 已存在 `setup-complete` 标记则跳过全部步骤
+
+### Prohibited Actions
+- 不删除已有目录或文件
+- 不修改项目代码

assets/skills/flow-tasks/SKILL.md

@@ -107,3 +107,38 @@ Sub Issue 不在 `/tasks` 阶段关闭，而是在对应 PR 合并后自动关
 
 ## 后续
 - **/code** — 认领 Sub Issue 开始编码
+
+## Contract
+
+### Trigger
+由 `/tasks` 命令或 `@dev-lifecycle` Phase 2 触发。
+
+### Inputs
+- `docs/dev/specs/<title>.md` — 技术方案
+- Parent Issue 编号
+
+### Preconditions
+- `/design` 已完成 → 技术方案和 ADR 存在
+
+### Procedure
+1. 基于技术方案拆解 DAG
+2. 创建 Task Manifest (`manifest.yaml`) 和任务文件
+3. 为每个任务创建 GitHub Sub Issue
+4. 通过 Planning PR 提交任务文件
+
+### Outputs
+- `docs/dev/tasks/<feature-slug>/manifest.yaml` — 任务清单
+- `docs/dev/tasks/<feature-slug>/*.md` — 任务文件
+- GitHub Sub Issues（含依赖声明）
+
+### Failure
+- DAG 存在环形依赖 → 阻止并报告
+- Sub Issue 创建失败 → 记录失败项
+
+### Idempotency
+- 任务文件已存在 → 读取并更新
+- Sub Issue 已创建 → 更新而非重复创建
+
+### Prohibited Actions
+- 不跳过 DAG 依赖检查
+- 不直接 push 到默认分支

assets/skills/flow-test/SKILL.md

@@ -42,3 +42,34 @@ gh pr checks <pr-number> --watch
 
 ## 后续
 - **/review** — 审查 PR
+
+## Contract
+
+### Trigger
+由 `/test` 命令触发。在已创建的 PR 上运行 CI 测试。
+
+### Inputs
+- PR 编号（来源：`/code` 产出）
+
+### Preconditions
+- `/code` 已完成 → PR 已创建
+
+### Procedure
+1. 检查 CI 配置是否存在
+2. 触发 CI 运行
+3. 监控运行状态
+4. 汇报结果
+
+### Outputs
+- CI 运行结果摘要
+
+### Failure
+- CI 失败 → 分析日志并建议修复
+- 无 CI 配置 → 引导用户创建 .github/workflows/ci.yml
+
+### Idempotency
+- 重复触发同一 PR → 覆盖前一次运行
+
+### Prohibited Actions
+- 不修改 CI 配置
+- 不触发非当前 PR 的 CI