claude-coder 1.8.2 → 1.8.4

package/bin/cli.js

@@ -1,172 +1,172 @@
-#!/usr/bin/env node
-'use strict';
-
-const pkg = require('../package.json');
-
-const COMMANDS = {
-  run:       { desc: '自动编码循环',             usage: 'claude-coder run [--max N] [--pause N] [--dry-run]' },
-  setup:     { desc: '交互式模型配置',           usage: 'claude-coder setup' },
-  init:      { desc: '初始化项目环境',           usage: 'claude-coder init' },
-  plan:      { desc: '生成计划方案',             usage: 'claude-coder plan "需求" | plan -r requirements.md [--planOnly] [-i]' },
-  simplify:  { desc: '代码审查和简化',           usage: 'claude-coder simplify [focus]' },
-  auth:      { desc: '导出 Playwright 登录状态', usage: 'claude-coder auth [url]' },
-  status:    { desc: '查看任务进度和成本',       usage: 'claude-coder status' },
-  go:        { desc: 'AI 驱动的需求组装',        usage: 'claude-coder go ["需求"] [-r file] [--reset]' },
-};
-
-function showHelp() {
-  console.log(`\nClaude Coder v${pkg.version}\n`);
-  console.log('用法: claude-coder <command> [options]\n');
-  console.log('命令:');
-  for (const [name, info] of Object.entries(COMMANDS)) {
-    console.log(`  ${name.padEnd(10)} ${info.desc}`);
-  }
-  console.log('\n示例:');
-  console.log('  claude-coder setup                   配置模型和 API Key');
-  console.log('  claude-coder plan "实现用户登录"      生成计划方案');
-  console.log('  claude-coder plan -r requirements.md 从文件读取需求');
-  console.log('  claude-coder plan --planOnly         仅生成计划文档');
-  console.log('  claude-coder plan -i "优化系统"      交互模式，允许模型提问');
-  console.log('  claude-coder run                     执行所有待处理任务');
-  console.log('  claude-coder run --max 1             单次执行');
-  console.log('  claude-coder run --max 5 --pause 5   每 5 个 session 暂停确认');
-  console.log('  claude-coder run --dry-run            预览模式');
-  console.log('  claude-coder simplify               代码审查和简化');
-  console.log('  claude-coder simplify "内存效率"     聚焦特定领域审查');
-  console.log('  claude-coder go                      对话式需求收集和方案组装');
-  console.log('  claude-coder go "用户管理页面"        AI 自动分析需求并组装方案');
-  console.log('  claude-coder go -r requirements.md   从文件读取需求并自动组装');
-  console.log('  claude-coder go --reset              重置 Go 记忆');
-  console.log('  claude-coder auth                    导出 Playwright 登录状态');
-  console.log('  claude-coder auth http://localhost:8080   指定登录 URL'); 
-  console.log('  claude-coder status                  查看进度和成本');
-  console.log(`\n前置条件: npm install -g @anthropic-ai/claude-agent-sdk`);
-}
-
-function parseArgs(argv) {
-  const args = argv.slice(2);
-  const command = args[0];
-  const opts = { max: 50, pause: 0, dryRun: false, readFile: null, model: null, n: 3, planOnly: false, interactive: false };
-  const positional = [];
-
-  for (let i = 1; i < args.length; i++) {
-    switch (args[i]) {
-      case '--max':
-        opts.max = parseInt(args[++i], 10) || 50;
-        break;
-      case '--pause':
-        { const v = parseInt(args[++i], 10); opts.pause = (v >= 0 && !isNaN(v)) ? v : 5; }
-        break;
-      case '--dry-run':
-        opts.dryRun = true;
-        break;
-      case '--model':
-        opts.model = args[++i] || null;
-        break;
-      case '-n':
-      case '--n':
-        opts.n = parseInt(args[++i], 10) || 3;
-        break;
-      case '-r': {
-        const next = args[i + 1];
-        if (next && !next.startsWith('-')) {
-          opts.readFile = next;
-          i++;
-        } else {
-          opts.readFile = 'requirements.md';
-        }
-        break;
-      }
-      case '--planOnly':
-        opts.planOnly = true;
-        break;
-      case '--reset':
-        opts.reset = true;
-        break;
-      case '-i':
-      case '--interactive':
-        opts.interactive = true;
-        break;
-      case '--help':
-      case '-h':
-        showHelp();
-        process.exit(0);
-        break;
-      default:
-        if (!args[i].startsWith('--')) {
-          positional.push(args[i]);
-        }
-        break;
-    }
-  }
-
-  return { command, positional, opts };
-}
-
-async function main() {
-  const { command, positional, opts } = parseArgs(process.argv);
-
-  if (!command || command === '--help' || command === '-h') {
-    showHelp();
-    process.exit(0);
-  }
-
-  if (command === '--version' || command === '-v') {
-    console.log(pkg.version);
-    process.exit(0);
-  }
-
-  switch (command) {
-    case 'run': {
-      const runner = require('../src/core/runner');
-      await runner.run(opts);
-      break;
-    }
-    case 'setup': {
-      const setup = require('../src/commands/setup');
-      await setup.setup();
-      break;
-    }
-    case 'init': {
-      const { init } = require('../src/core/init');
-      await init();
-      break;
-    }
-    case 'plan': {
-      const { run: planRun } = require('../src/core/plan');
-      const input = positional[0] || '';
-      await planRun(input, opts);
-      break;
-    }
-    case 'simplify': {
-      const { simplify } = require('../src/core/simplify');
-      await simplify(positional[0] || null, { n: opts.n });
-      break;
-    }
-    case 'auth': {
-      const { auth } = require('../src/commands/auth');
-      await auth(positional[0] || null);
-      break;
-    }
-    case 'go': {
-      const { run: goRun } = require('../src/core/go');
-      await goRun(positional[0] || '', opts);
-      break;
-    }
-    case 'status': {
-      const tasks = require('../src/common/tasks');
-      tasks.showStatus();
-      break;
-    }
-    default:
-      console.error(`未知命令: ${command}`);
-      showHelp();
-      process.exit(1);
-  }
-}
-
-main().catch(err => {
-  console.error(`\n错误: ${err.message}`);
-  if (process.env.DEBUG) console.error(err.stack);
-  process.exit(1);
-});
+#!/usr/bin/env node
+'use strict';
+
+const pkg = require('../package.json');
+
+const COMMANDS = {
+  run:       { desc: '自动编码循环',             usage: 'claude-coder run [--max N] [--pause N] [--dry-run]' },
+  setup:     { desc: '交互式模型配置',           usage: 'claude-coder setup' },
+  init:      { desc: '初始化项目环境',           usage: 'claude-coder init' },
+  plan:      { desc: '生成计划方案',             usage: 'claude-coder plan "需求" | plan -r requirements.md [--planOnly] [-i]' },
+  simplify:  { desc: '代码审查和简化',           usage: 'claude-coder simplify [focus]' },
+  auth:      { desc: '导出 Playwright 登录状态', usage: 'claude-coder auth [url]' },
+  status:    { desc: '查看任务进度和成本',       usage: 'claude-coder status' },
+  go:        { desc: 'AI 驱动的需求组装',        usage: 'claude-coder go ["需求"] [-r file] [--reset]' },
+};
+
+function showHelp() {
+  console.log(`\nClaude Coder v${pkg.version}\n`);
+  console.log('用法: claude-coder <command> [options]\n');
+  console.log('命令:');
+  for (const [name, info] of Object.entries(COMMANDS)) {
+    console.log(`  ${name.padEnd(10)} ${info.desc}`);
+  }
+  console.log('\n示例:');
+  console.log('  claude-coder setup                   配置模型和 API Key');
+  console.log('  claude-coder plan "实现用户登录"      生成计划方案');
+  console.log('  claude-coder plan -r requirements.md 从文件读取需求');
+  console.log('  claude-coder plan --planOnly         仅生成计划文档');
+  console.log('  claude-coder plan -i "优化系统"      交互模式，允许模型提问');
+  console.log('  claude-coder run                     执行所有待处理任务');
+  console.log('  claude-coder run --max 1             单次执行');
+  console.log('  claude-coder run --max 5 --pause 5   每 5 个 session 暂停确认');
+  console.log('  claude-coder run --dry-run            预览模式');
+  console.log('  claude-coder simplify               代码审查和简化');
+  console.log('  claude-coder simplify "内存效率"     聚焦特定领域审查');
+  console.log('  claude-coder go                      对话式需求收集和方案组装');
+  console.log('  claude-coder go "用户管理页面"        AI 自动分析需求并组装方案');
+  console.log('  claude-coder go -r requirements.md   从文件读取需求并自动组装');
+  console.log('  claude-coder go --reset              重置 Go 记忆');
+  console.log('  claude-coder auth                    导出 Playwright 登录状态');
+  console.log('  claude-coder auth http://localhost:8080   指定登录 URL'); 
+  console.log('  claude-coder status                  查看进度和成本');
+  console.log(`\n前置条件: npm install -g @anthropic-ai/claude-agent-sdk`);
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const command = args[0];
+  const opts = { max: 50, pause: 0, dryRun: false, readFile: null, model: null, n: 3, planOnly: false, interactive: false };
+  const positional = [];
+
+  for (let i = 1; i < args.length; i++) {
+    switch (args[i]) {
+      case '--max':
+        opts.max = parseInt(args[++i], 10) || 50;
+        break;
+      case '--pause':
+        { const v = parseInt(args[++i], 10); opts.pause = (v >= 0 && !isNaN(v)) ? v : 5; }
+        break;
+      case '--dry-run':
+        opts.dryRun = true;
+        break;
+      case '--model':
+        opts.model = args[++i] || null;
+        break;
+      case '-n':
+      case '--n':
+        opts.n = parseInt(args[++i], 10) || 3;
+        break;
+      case '-r': {
+        const next = args[i + 1];
+        if (next && !next.startsWith('-')) {
+          opts.readFile = next;
+          i++;
+        } else {
+          opts.readFile = 'requirements.md';
+        }
+        break;
+      }
+      case '--planOnly':
+        opts.planOnly = true;
+        break;
+      case '--reset':
+        opts.reset = true;
+        break;
+      case '-i':
+      case '--interactive':
+        opts.interactive = true;
+        break;
+      case '--help':
+      case '-h':
+        showHelp();
+        process.exit(0);
+        break;
+      default:
+        if (!args[i].startsWith('--')) {
+          positional.push(args[i]);
+        }
+        break;
+    }
+  }
+
+  return { command, positional, opts };
+}
+
+async function main() {
+  const { command, positional, opts } = parseArgs(process.argv);
+
+  if (!command || command === '--help' || command === '-h') {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (command === '--version' || command === '-v') {
+    console.log(pkg.version);
+    process.exit(0);
+  }
+
+  switch (command) {
+    case 'run': {
+      const runner = require('../src/core/runner');
+      await runner.run(opts);
+      break;
+    }
+    case 'setup': {
+      const setup = require('../src/commands/setup');
+      await setup.setup();
+      break;
+    }
+    case 'init': {
+      const { init } = require('../src/core/init');
+      await init();
+      break;
+    }
+    case 'plan': {
+      const { run: planRun } = require('../src/core/plan');
+      const input = positional[0] || '';
+      await planRun(input, opts);
+      break;
+    }
+    case 'simplify': {
+      const { simplify } = require('../src/core/simplify');
+      await simplify(positional[0] || null, { n: opts.n });
+      break;
+    }
+    case 'auth': {
+      const { auth } = require('../src/commands/auth');
+      await auth(positional[0] || null);
+      break;
+    }
+    case 'go': {
+      const { run: goRun } = require('../src/core/go');
+      await goRun(positional[0] || '', opts);
+      break;
+    }
+    case 'status': {
+      const tasks = require('../src/common/tasks');
+      tasks.showStatus();
+      break;
+    }
+    default:
+      console.error(`未知命令: ${command}`);
+      showHelp();
+      process.exit(1);
+  }
+}
+
+main().catch(err => {
+  console.error(`\n错误: ${err.message}`);
+  if (process.env.DEBUG) console.error(err.stack);
+  process.exit(1);
+});

package/package.json

@@ -1,52 +1,53 @@
-{
-  "name": "claude-coder",
-  "version": "1.8.2",
-  "description": "Claude Coder — Autonomous coding agent harness powered by Claude Code SDK. Scan, plan, code, validate, git-commit in a loop.",
-  "bin": {
-    "claude-coder": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "templates/"
-  ],
-  "scripts": {
-    "test": "node test/complete.test.js && node test/integration.test.js && node test/flow.test.js"
-  },
-  "keywords": [
-    "claude-coder",
-    "claude",
-    "claude-code",
-    "ai",
-    "agent",
-    "autonomous",
-    "automation",
-    "coding",
-    "harness",
-    "loop",
-    "agent-harness",
-    "task-decomposition",
-    "code-generation"
-  ],
-  "author": "lk19940215",
-  "license": "MIT",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/lk19940215/claude-coder.git"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "peerDependencies": {
-    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
-  },
-  "optionalDependencies": {
-    "playwright": "^1.58.2"
-  },
-  "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.71"
-  }
-}
+{
+  "name": "claude-coder",
+  "version": "1.8.4",
+  "description": "Claude Coder — Autonomous coding agent harness powered by Claude Code SDK. Scan, plan, code, validate, git-commit in a loop.",
+  "bin": {
+    "claude-coder": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "recipes/",
+    "templates/"
+  ],
+  "scripts": {
+    "test": "node test/complete.test.js && node test/integration.test.js && node test/flow.test.js"
+  },
+  "keywords": [
+    "claude-coder",
+    "claude",
+    "claude-code",
+    "ai",
+    "agent",
+    "autonomous",
+    "automation",
+    "coding",
+    "harness",
+    "loop",
+    "agent-harness",
+    "task-decomposition",
+    "code-generation"
+  ],
+  "author": "lk19940215",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lk19940215/claude-coder.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.71"
+  }
+}

package/recipes/_shared/roles/developer.md

@@ -0,0 +1,11 @@
+# 角色：开发者
+
+## Plan 阶段提示
+用户是有经验的开发者。请注意：
+- 方案可包含技术细节：API 设计、数据模型、组件结构
+- 尊重用户指定的技术约束（框架、组件库、API 风格等）
+- 如用户未指定，根据项目现有技术栈推荐
+
+## Task 分解提示
+- steps 可包含具体的技术步骤
+- 验证步骤使用技术命令：curl、Playwright、lint 检查等

package/recipes/_shared/roles/product.md

@@ -0,0 +1,12 @@
+# 角色：产品经理
+
+## Plan 阶段提示
+用户是非技术产品经理。请注意：
+- 用简单语言描述方案，避免技术术语
+- 技术选型自动采用项目现有方案或最佳推荐，不需要用户确认
+- 关注功能完整性和用户体验，而非实现细节
+- 生成方案后，输出一个功能确认清单（纯业务语言）
+
+## Task 分解提示
+- steps 描述侧重"做什么"而非"怎么做"
+- 验证步骤用业务语言描述："能看到用户列表"而非"curl GET /api/users → 200"

package/recipes/_shared/roles/tester.md

@@ -0,0 +1,12 @@
+# 角色：测试
+
+## Plan 阶段提示
+用户关注测试覆盖和质量保障。请注意：
+- 方案重点描述验收标准和测试场景
+- 每个功能点需列出正向 + 异常场景
+- 关注边界条件：空数据、超长输入、并发操作
+
+## Task 分解提示
+- 每个功能对应的 test 任务应详细列出测试用例
+- steps 用 P0/P1/P2 标记优先级
+- 包含：正向流程、异常流程、边界测试

package/recipes/_shared/test/report-format.md

@@ -0,0 +1,86 @@
+# 测试报告输出规范
+
+测试任务完成后，必须输出两个报告文件。
+
+## 1. 结构化数据：.claude-coder/test-report.json
+
+```json
+{
+  "project": "项目名",
+  "timestamp": "ISO-8601 时间戳",
+  "summary": {
+    "total": 10,
+    "passed": 8,
+    "failed": 2,
+    "skipped": 0
+  },
+  "duration_ms": 45000,
+  "cases": [
+    {
+      "id": "TC-001",
+      "name": "列表加载",
+      "priority": "P0",
+      "status": "passed",
+      "duration_ms": 2300,
+      "steps": [
+        { "description": "导航到列表页", "status": "passed" },
+        { "description": "验证表格存在", "status": "passed" }
+      ],
+      "error": null
+    },
+    {
+      "id": "TC-002",
+      "name": "新建功能",
+      "priority": "P0",
+      "status": "failed",
+      "duration_ms": 5200,
+      "steps": [
+        { "description": "点击新建按钮", "status": "passed" },
+        { "description": "填写表单", "status": "passed" },
+        { "description": "提交", "status": "failed" }
+      ],
+      "error": "表单校验未触发，直接提交成功"
+    }
+  ],
+  "environment": {
+    "browser": "chromium",
+    "baseUrl": "http://localhost:xxxx"
+  }
+}
+```
+
+## 2. 可读报告：.claude-coder/test-report.md
+
+格式模板：
+
+```markdown
+# 测试报告 — {项目名}
+
+> 时间: {timestamp} | 通过率: {passed}/{total} | 耗时: {duration}s
+
+## 摘要
+
+| 指标 | 数值 |
+|------|------|
+| 总用例 | {total} |
+| 通过 | {passed} |
+| 失败 | {failed} |
+| 跳过 | {skipped} |
+
+## 详细结果
+
+### ✅ [P0] 列表加载 — PASSED (2.3s)
+1. 导航到列表页 ✓
+2. 验证表格存在 ✓
+
+### ❌ [P0] 新建功能 — FAILED (5.2s)
+1. 点击新建按钮 ✓
+2. 填写表单 ✓
+3. 提交 ✗ — 表单校验未触发
+
+## 失败用例汇总
+
+| 用例 | 优先级 | 失败原因 |
+|------|--------|----------|
+| 新建功能 | P0 | 表单校验未触发 |
+```

package/recipes/backend/base.md

@@ -0,0 +1,27 @@
+# 后端服务 — 基础食谱
+
+## 任务分解模式
+
+后端服务按以下标准拆分：
+
+1. **infra**: 项目结构（如未有后端框架，需初始化）
+   - steps：框架搭建、目录结构、数据库连接、中间件配置
+   - 验证：服务启动成功，健康检查接口返回 200
+
+2. **backend**: 数据模型 + API 接口
+   - steps：Model 定义、CRUD Service、Controller/Router、参数校验
+   - 验证：curl 测试所有接口返回正确响应
+
+3. **backend**: 业务逻辑（复杂场景单独拆分）
+   - steps：业务规则、数据转换、关联查询
+   - 验证：curl 测试边界场景
+
+4. **test**: API 测试
+   - steps：正向流程、参数校验、权限校验、边界测试
+
+## 通用规则
+
+- 一个资源（如 users）的完整 CRUD 合为一个 backend 任务
+- 认证鉴权如果与 CRUD 无关，拆为独立任务
+- 每个接口必须有参数校验
+- 错误响应格式统一

package/recipes/backend/components/auth.md

@@ -0,0 +1,18 @@
+# 认证鉴权
+
+## 任务分解指导
+认证鉴权拆为独立 backend 任务，不与 CRUD 混合。
+
+## 实现要点
+- 注册：用户名/邮箱 + 密码，密码 hash 存储
+- 登录：验证凭证，返回 JWT token 或设置 session
+- Token 验证中间件：拦截受保护路由
+- 角色权限：admin / editor / viewer 等，按路由或按操作控制
+- Token 刷新/续期机制
+
+## 验证策略
+- curl 注册 → 201
+- curl 登录 → 200 + token
+- curl 无 token 访问受保护路由 → 401
+- curl 带 token 访问 → 200
+- curl 权限不足 → 403

package/recipes/backend/components/crud-api.md

@@ -0,0 +1,18 @@
+# RESTful CRUD API
+
+## 任务分解指导
+一个资源的完整 CRUD 合为一个 backend 任务。
+
+## 实现要点
+- RESTful 风格：GET /资源（列表）、GET /资源/:id（详情）、POST（创建）、PUT（更新）、DELETE（删除）
+- 列表分页：`?page=1&pageSize=10`，返回 `{ data: [], total: N }`
+- 搜索过滤：`?keyword=xxx&status=active`
+- 排序：`?sortBy=createdAt&order=desc`
+- 参数校验：必填项、类型、长度、格式
+- 错误响应统一格式：`{ code: 400, message: "xxx" }`
+
+## 验证策略
+- curl POST 创建 → 201 + 返回创建的数据
+- curl GET 列表 → 200 + 分页结构正确
+- curl PUT 更新 → 200 + 数据变更
+- curl DELETE → 200 + 再 GET 确认已删除

package/recipes/backend/components/file-service.md

@@ -0,0 +1,15 @@
+# 文件服务
+
+## 任务分解指导
+文件服务如逻辑简单可合入 CRUD 任务，复杂时独立拆分。
+
+## 实现要点
+- 上传接口：multipart/form-data，校验类型和大小
+- 存储：本地文件系统 / 对象存储（S3/OSS）
+- 下载/访问：静态文件服务或签名 URL
+- 文件元信息：原始名、大小、MIME 类型、上传时间
+
+## 验证策略
+- curl 上传文件 → 200 + 返回 fileId/URL
+- curl 访问上传的文件 → 200 + 内容正确
+- curl 上传超限文件 → 400 + 错误提示