dev-playbooks-cn 1.2.3 → 1.2.5

package/README.md

@@ -46,6 +46,7 @@ AI 编码助手很强大，但往往**不可预测**：
 | **Claude Code** | 完整 Skills | `CLAUDE.md` |
 | **Codex CLI** | 完整 Skills | `AGENTS.md` |
 | **Qoder** | 完整 Skills | `AGENTS.md` |
+| **OpenCode（oh-my-opencode）** | 完整 Skills | `AGENTS.md` |
 | **Cursor** | Rules 系统 | `.cursor/rules/` |
 | **Windsurf** | Rules 系统 | `.windsurf/rules/` |
 | **Gemini CLI** | Rules 系统 | `GEMINI.md` |
@@ -83,6 +84,7 @@ npx dev-playbooks-cn@latest init
 初始化后：
 - Claude Code：`~/.claude/skills/devbooks-*`
 - Codex CLI：`~/.codex/skills/devbooks-*`
+- OpenCode：`~/.config/opencode/skill/devbooks-*`
 
 ### 快速集成
 

package/bin/devbooks.js

@@ -32,6 +32,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 const CLI_COMMAND = 'dev-playbooks-cn';
+const XDG_CONFIG_HOME = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
 
 // ============================================================================
 // Skills 支持级别定义
@@ -71,6 +72,18 @@ const AI_TOOLS = [
     instructionFile: 'AGENTS.md',
     available: true
   },
+  {
+    id: 'opencode',
+    name: 'OpenCode',
+    description: 'OpenCode AI CLI (compatible with oh-my-opencode)',
+    skillsSupport: SKILLS_SUPPORT.FULL,
+    slashDir: '.opencode/command',
+    agentsDir: '.opencode/agent',
+    skillsDir: path.join(XDG_CONFIG_HOME, 'opencode', 'skill'),
+    globalDir: path.join(XDG_CONFIG_HOME, 'opencode'),
+    instructionFile: 'AGENTS.md',
+    available: true
+  },
 
   // === Rules 类似系统 ===
   {
@@ -115,17 +128,6 @@ const AI_TOOLS = [
     instructionFile: 'GEMINI.md',
     available: true
   },
-  {
-    id: 'opencode',
-    name: 'OpenCode',
-    description: 'OpenCode AI CLI',
-    skillsSupport: SKILLS_SUPPORT.RULES,
-    slashDir: '.opencode/commands/devbooks',
-    agentsDir: '.opencode/agent',
-    globalDir: path.join(os.homedir(), '.config', 'opencode'),
-    instructionFile: 'AGENTS.md',
-    available: true
-  },
 
   // === Agents/自定义指令 ===
   {
@@ -473,11 +475,11 @@ function printSkillsSupportInfo() {
   console.log(chalk.gray('─'.repeat(50)));
   console.log();
 
-  console.log(chalk.green('★ 完整 Skills') + chalk.gray(' - Claude Code, Codex CLI, Qoder'));
+  console.log(chalk.green('★ 完整 Skills') + chalk.gray(' - Claude Code, Codex CLI, OpenCode, Qoder'));
   console.log(chalk.gray('   └ 独立的 Skills/Agents 系统，可按需调用，有独立上下文'));
   console.log();
 
-  console.log(chalk.blue('◆ Rules 系统') + chalk.gray(' - Cursor, Windsurf, Gemini, Antigravity, OpenCode, Continue'));
+  console.log(chalk.blue('◆ Rules 系统') + chalk.gray(' - Cursor, Windsurf, Gemini, Antigravity, Continue'));
   console.log(chalk.gray('   └ 规则自动应用于匹配的文件/场景，功能接近 Skills'));
   console.log();
 
@@ -550,8 +552,8 @@ function installSkills(toolIds, update = false) {
     const tool = AI_TOOLS.find(t => t.id === toolId);
     if (!tool || tool.skillsSupport !== SKILLS_SUPPORT.FULL) continue;
 
-    // Claude Code 和 Codex CLI 都支持相同格式的 Skills
-    if ((toolId === 'claude' || toolId === 'codex') && tool.skillsDir) {
+    // Claude Code / Codex CLI / OpenCode（含 oh-my-opencode）支持相同格式的 Skills
+    if ((toolId === 'claude' || toolId === 'codex' || toolId === 'opencode') && tool.skillsDir) {
       const skillsSrcDir = path.join(__dirname, '..', 'skills');
       const skillsDestDir = tool.skillsDir;
 
@@ -612,6 +614,72 @@ function installSkills(toolIds, update = false) {
   return results;
 }
 
+// ============================================================================
+// OpenCode：安装项目级命令入口（.opencode/command/devbooks.md）
+// ============================================================================
+
+function generateOpenCodeDevbooksCommand() {
+  return `---
+description: DevBooks 工作流入口（OpenCode / oh-my-opencode）
+---
+
+${DEVBOOKS_MARKERS.start}
+# DevBooks（OpenCode / oh-my-opencode）
+
+本项目使用 DevBooks 工作流进行规格驱动开发。
+
+## 快速开始
+
+1. **推荐入口（Router）**：在对话中输入：\`/devbooks-router\`
+2. 或使用自然语言：\`请运行 devbooks-router skill，分析需求：<你的需求>\`
+
+> 说明：在 oh-my-opencode 中，Skills 会作为可用的 Slash Commands 被加载，因此可以直接用 \`/<skill-name>\` 调用。
+
+## 常用命令（直接用 /<skill-name>）
+
+- \`/devbooks-router\`：入口路由（自动判断下一步）
+- \`/devbooks-impact-analysis\`：影响分析（跨模块/对外契约）
+- \`/devbooks-proposal-author\`：创建提案（禁止编码）
+- \`/devbooks-design-doc\`：设计文档（What/Constraints + AC）
+- \`/devbooks-implementation-plan\`：编码计划（tasks.md）
+- \`/devbooks-test-owner\`：验收测试与追溯（独立对话）
+- \`/devbooks-coder\`：按 tasks 实现（禁止改 tests/）
+- \`/devbooks-spec-gardener\`：归档前规格修剪
+
+## 核心约束（必须遵守）
+
+- 在回答任何问题或写任何代码前：先做配置发现并阅读规则文档（\`.devbooks/config.yaml\` → \`dev-playbooks/project.md\` → \`project.md\`）
+- 新功能/破坏性变更/架构改动：必须先创建 \`dev-playbooks/changes/<id>/\` 并产出 proposal/design/tasks/verification
+- Test Owner 与 Coder 必须在独立对话/独立实例中执行；Coder 禁止修改 \`tests/**\`
+
+${DEVBOOKS_MARKERS.end}
+`;
+}
+
+function installOpenCodeCommands(toolIds, projectDir, update = false) {
+  const results = [];
+
+  if (!toolIds.includes('opencode')) return results;
+
+  const destDir = path.join(projectDir, '.opencode', 'command');
+  fs.mkdirSync(destDir, { recursive: true });
+
+  const destPath = path.join(destDir, 'devbooks.md');
+  const content = generateOpenCodeDevbooksCommand();
+
+  if (!fs.existsSync(destPath)) {
+    fs.writeFileSync(destPath, content);
+    results.push({ tool: 'OpenCode', type: 'command', path: destPath, action: 'created' });
+  } else if (update) {
+    const updated = updateManagedContent(destPath, content);
+    if (updated) {
+      results.push({ tool: 'OpenCode', type: 'command', path: destPath, action: 'updated' });
+    }
+  }
+
+  return results;
+}
+
 // ============================================================================
 // 安装 Claude Code 自定义子代理（解决内置子代理无法访问 Skills 的问题）
 // ============================================================================
@@ -1088,6 +1156,12 @@ async function initCommand(projectDir, options) {
     console.log(chalk.gray(`  └ ${result.tool}: ${path.relative(projectDir, result.path)}`));
   }
 
+  // OpenCode：安装项目级命令入口（.opencode/command/devbooks.md）
+  const openCodeCmdResults = installOpenCodeCommands(selectedTools, projectDir);
+  for (const result of openCodeCmdResults) {
+    console.log(chalk.gray(`  └ ${result.tool}: ${path.relative(projectDir, result.path)}`));
+  }
+
   // 设置 ignore 文件
   const ignoreSpinner = ora('配置 ignore 文件...').start();
   const ignoreResults = setupIgnoreFiles(selectedTools, projectDir);
@@ -1197,6 +1271,14 @@ async function updateCommand(projectDir) {
     }
   }
 
+  // OpenCode：更新项目级命令入口（.opencode/command/devbooks.md）
+  const openCodeCmdResults = installOpenCodeCommands(configuredTools, projectDir, true);
+  for (const result of openCodeCmdResults) {
+    if (result.action === 'updated') {
+      console.log(chalk.green('✓') + ` ${result.tool}: 更新了命令入口 ${path.relative(projectDir, result.path)}`);
+    }
+  }
+
   console.log();
   console.log(chalk.green('✓') + ' 更新完成！');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",

package/skills/devbooks-code-review/SKILL.md

@@ -148,6 +148,15 @@ override dispose() {
 | 无 spec deltas | 归档完成 | 无需其他 skill |
 | 发现重大问题 | 交回 `devbooks-coder` | 归档前修复问题 |
 
+### Reviewer 专属权限：设置 verification.md Status
+
+**只有 Reviewer 可以将 `verification.md` 的 Status 设为 `Done`**。
+
+Review 通过后，Reviewer 必须执行：
+1. 打开 `<change-root>/<change-id>/verification.md`
+2. 将 `- Status: Ready` 改为 `- Status: Done`
+3. 这是归档的前置条件（`change-check.sh --mode archive` 会检查）
+
 ### 输出模板
 
 完成 code-review 后，输出：

package/skills/devbooks-coder/SKILL.md

@@ -141,6 +141,7 @@ devbooks change-evidence <change-id> --label green-final -- npm test
 ### 角色边界约束
 - **禁止修改 `tests/**`**（需要改测试必须交还 Test Owner）
 - **禁止修改 `verification.md`**（由 Test Owner 维护）
+- **禁止修改 `verification.md` 的 Status 字段**（只有 Reviewer 可以设为 Done）
 - **禁止修改 `.devbooks/`、`build/`、工程配置文件**（除非 proposal.md 明确声明）
 
 ### 代码质量约束

package/skills/devbooks-delivery-workflow/scripts/change-check.sh

@@ -410,6 +410,25 @@ check_verification() {
     return 0
   fi
 
+  # ==========================================================================
+  # AC-010: Verification Status Check
+  # Status field controls change package lifecycle: Draft → Ready → Done → Archived
+  # Only Reviewer can set Status to "Done" (Coder/Test Owner prohibited)
+  # ==========================================================================
+  if [[ "$mode" == "archive" || "$mode" == "strict" ]]; then
+    local status_line
+    status_line=$(rg -n "^- Status[:：] *(Draft|Ready|Done|Archived)\b" "$verification_file" -m 1 || true)
+    if [[ -z "$status_line" ]]; then
+      err "verification missing Status line (e.g., '- Status: Done'): ${verification_file}"
+    else
+      local status_value
+      status_value="$(echo "$status_line" | sed -E 's/^[0-9]+:- Status[:：] *//')"
+      if [[ "$status_value" != "Done" && "$status_value" != "Archived" ]]; then
+        err "verification Status must be 'Done' or 'Archived' for ${mode} (current: '${status_value}'). Only Reviewer can set Status to Done: ${verification_file}"
+      fi
+    fi
+  fi
+
   for h in "A\) (Test Plan Directive Table|测试计划指令表)" "B\) (Traceability Matrix|追溯矩阵)" "C\) (Execution Anchors|执行锚点)" "D\) (MANUAL-\* Checklist|MANUAL-\* 清单)"; do
     if ! rg -n "${h}" "$verification_file" >/dev/null; then
       err "verification missing section '${h}': ${verification_file}"

package/skills/devbooks-delivery-workflow/scripts/change-scaffold.sh

@@ -263,7 +263,13 @@ cat <<'EOF' | render_template | write_file "${change_dir}/verification.md"
 ## Metadata
 
 - Change ID: `__CHANGE_ID__`
-- Status: Draft | Ready | Done | Archived
+- Status: Draft
+  > Status lifecycle: Draft → Ready → Done → Archived
+  > - Draft: Initial state
+  > - Ready: Test plan ready (set by Test Owner)
+  > - Done: All tests passed + Review approved (set by **Reviewer only**)
+  > - Archived: Archived (set by Spec Gardener)
+  > **Constraint: Coder is prohibited from modifying Status field**
 - References:
   - Proposal: `__CHANGE_ROOT__/__CHANGE_ID__/proposal.md`
   - Design: `__CHANGE_ROOT__/__CHANGE_ID__/design.md`

package/skills/devbooks-test-owner/SKILL.md

@@ -40,6 +40,17 @@ allowed-tools:
 
 Test Owner 必须产出结构化的 `verification.md`，同时作为测试计划和追溯文档。
 
+### Status 字段权限
+
+| 状态 | 含义 | 谁可以设置 |
+|------|------|-----------|
+| `Draft` | 初始状态 | 自动生成 |
+| `Ready` | 测试计划就绪 | **Test Owner** |
+| `Done` | Review 通过 | Reviewer（禁止 Test Owner/Coder） |
+| `Archived` | 已归档 | Spec Gardener |
+
+**约束**：Test Owner 完成测试计划后，应将 Status 设为 `Ready`。
+
 ```markdown
 # 验证计划：<change-id>
 

package/templates/dev-playbooks/README.md

@@ -61,6 +61,7 @@ AI 编码助手很强大，但往往**不可预测**：
 | **Claude Code** | 完整 Skills | `CLAUDE.md` |
 | **Codex CLI** | 完整 Skills | `AGENTS.md` |
 | **Qoder** | 完整 Skills | `AGENTS.md` |
+| **OpenCode（oh-my-opencode）** | 完整 Skills | `AGENTS.md` |
 | **Cursor** | Rules 系统 | `.cursor/rules/` |
 | **Windsurf** | Rules 系统 | `.windsurf/rules/` |
 | **Gemini CLI** | Rules 系统 | `GEMINI.md` |
@@ -98,6 +99,7 @@ npx dev-playbooks-cn@latest init
 初始化后：
 - Claude Code：`~/.claude/skills/devbooks-*`
 - Codex CLI：`~/.codex/skills/devbooks-*`
+- OpenCode：`~/.config/opencode/skill/devbooks-*`
 
 ### 快速集成