dev-playbooks-cn 1.2.2 → 1.2.4

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.2",
+  "version": "1.2.4",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",

package/skills/devbooks-implementation-plan/references//347/274/226/347/240/201/350/256/241/345/210/222/346/217/220/347/244/272/350/257/215.md

@@ -73,8 +73,18 @@
   主线计划区写法规范（强制）：
   - 每个任务包必须有：目的（Why）、交付物（Deliverables）、影响范围（Files/Modules）、验收标准（Acceptance
   Criteria）、依赖（Dependencies）、风险（Risks）。
-  - 子任务写到“接口/契约/行为边界”为止，不写函数体实现。
-  - 验收标准必须“可观察、可测试”：优先写成“新增/更新哪些测试用例、通过哪些验收检查、关键指标达到什么阈值”。
+  - 子任务写到"接口/契约/行为边界"为止，不写函数体实现。
+  - 验收标准必须"可观察、可测试"：优先写成"新增/更新哪些测试用例、通过哪些验收检查、关键指标达到什么阈值"。
+  - **任务勾选框格式（强制）**：每个子任务必须使用 Markdown 任务列表格式 `- [ ]`，以支持 Coder 的断点续做协议。
+    - 初始状态全部为 `- [ ]`（未完成）
+    - Coder 完成后会标记为 `- [x]`（已完成）
+    - 子任务标题必须写在 `- [ ] MPx.y ...` 这一行内，不要用 `#### MPx.y:` 标题替代勾选框
+    - 示例格式：
+      ```markdown
+      ### MP1: 任务包名称
+      - [ ] MP1.1 子任务描述
+      - [ ] MP1.2 子任务描述
+      ```
 
   临时计划区写法规范（强制）：
   - 仅用于计划外高优任务；需要说明：触发原因、影响面、最小修复范围、回归测试要求。

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-*`
 
 ### 快速集成