claude-coder 1.8.0 → 1.8.2

package/src/core/prompts.js

@@ -1,253 +1,227 @@
-'use strict';
-
-const { loadConfig } = require('../common/config');
-const { assets } = require('../common/assets');
-const { loadTasks, findNextTask, getStats } = require('../common/tasks');
-
-// --------------- System Prompt ---------------
-
-function buildSystemPrompt(includeScanProtocol = false) {
-  let prompt = assets.read('agentProtocol');
-  if (includeScanProtocol) {
-    const scan = assets.read('scanProtocol');
-    if (scan) prompt += '\n\n' + scan;
-  }
-  return prompt;
-}
-
-// --------------- Hint Builders ---------------
-
-function buildMcpHint(config) {
-  return config.mcpPlaywright
-    ? '前端/全栈任务可用 Playwright MCP（browser_navigate、browser_snapshot、browser_click 等）做端到端测试。'
-    : '';
-}
-
-function buildRetryHint(consecutiveFailures, lastValidateLog) {
-  if (consecutiveFailures > 0 && lastValidateLog) {
-    return `\n注意：上次会话校验失败，原因：${lastValidateLog}。请避免同样的问题。`;
-  }
-  return '';
-}
-
-function buildEnvHint(consecutiveFailures, sessionNum) {
-  if (consecutiveFailures === 0 && sessionNum > 1) {
-    return '环境已就绪，第二步可跳过 claude-coder init，仅确认服务存活。涉及新依赖时仍需运行 claude-coder init。';
-  }
-  return '';
-}
-
-function buildTestHint() {
-  const testsData = assets.readJson('tests', null);
-  if (testsData) {
-    const count = (testsData.test_cases || []).length;
-    if (count > 0) return `tests.json 已有 ${count} 条验证记录，Step 5 时先查已有记录避免重复验证。`;
-  }
-  return '';
-}
-
-function buildDocsHint() {
-  const profile = assets.readJson('profile', null);
-  if (!profile) return '';
-  let hint = '';
-  const docs = profile.existing_docs || [];
-  if (docs.length > 0) {
-    hint = `项目文档: ${docs.join(', ')}。Step 4 编码前先读与任务相关的文档，了解接口约定和编码规范。完成后若新增了模块或 API，更新对应文档。`;
-  }
-  if (profile.tech_stack?.backend?.framework &&
-      (!profile.services || profile.services.length === 0)) {
-    hint += ' 注意：project_profile.json 的 services 为空，请在本次 session 末尾补全 services 数组（command, port, health_check）。';
-  }
-  if (!docs.length) {
-    hint += ' 注意：project_profile.json 的 existing_docs 为空，请在 Step 6 收尾时补全文档列表。';
-  }
-  return hint;
-}
-
-function buildTaskHint(projectRoot) {
-  try {
-    const taskData = loadTasks();
-    if (!taskData) return '';
-    const next = findNextTask(taskData);
-    const stats = getStats(taskData);
-    if (next) {
-      return `任务上下文: ${next.id} "${next.description}" (${next.status}), ` +
-        `category=${next.category}, steps=${next.steps.length}步。` +
-        `进度: ${stats.done}/${stats.total} done, ${stats.failed} failed。` +
-        `项目绝对路径: ${projectRoot}。运行时目录: ${projectRoot}/.claude-coder/（隐藏目录）。` +
-        `第一步无需读取 tasks.json（已注入），直接确认任务后进入 Step 2。`;
-    }
-  } catch { /* ignore */ }
-  return '';
-}
-
-function buildTestEnvHint(projectRoot) {
-  if (assets.exists('testEnv')) {
-    return `测试凭证文件: ${projectRoot}/.claude-coder/test.env（含 API Key、测试账号等），测试前用 source ${projectRoot}/.claude-coder/test.env 加载。发现新凭证需求时可追加写入（KEY=value 格式）。`;
-  }
-  return `如需持久化测试凭证（API Key、测试账号密码等），写入 ${projectRoot}/.claude-coder/test.env（KEY=value 格式，每行一个）。后续 session 会自动感知。`;
-}
-
-function buildPlaywrightAuthHint(config) {
-  if (!config.mcpPlaywright) return '';
-  const mode = config.playwrightMode;
-  switch (mode) {
-    case 'persistent':
-      return 'Playwright MCP 使用 persistent 模式（user-data-dir），浏览器登录状态持久保存在本地配置中，无需额外登录操作。';
-    case 'isolated':
-      return assets.exists('playwrightAuth')
-        ? 'Playwright MCP 使用 isolated 模式，已检测到登录状态文件（playwright-auth.json），每次会话自动加载 cookies 和 localStorage。'
-        : 'Playwright MCP 使用 isolated 模式，但未检测到登录状态文件。如目标页面需要登录，请先运行 claude-coder auth <URL>。';
-    case 'extension':
-      return 'Playwright MCP 使用 extension 模式，已连接用户真实浏览器，直接复用浏览器已有的登录态和扩展。注意：操作会影响用户正在使用的浏览器。';
-    default:
-      return '';
-  }
-}
-
-function buildMemoryHint() {
-  const sr = assets.readJson('sessionResult', null);
-  if (sr?.session_result) {
-    return `上次会话: ${sr.session_result}（${sr.status_before || '?'} → ${sr.status_after || '?'}）` +
-      (sr.notes ? `, 要点: ${sr.notes.slice(0, 150)}` : '') + '。';
-  }
-  return '';
-}
-
-function buildServiceHint(maxSessions) {
-  return maxSessions === 1
-    ? '单次模式：收尾时停止所有后台服务。'
-    : '连续模式：收尾时不要停止后台服务，保持服务运行以便下个 session 继续使用。';
-}
-
-// --------------- Coding Session ---------------
-
-function buildCodingPrompt(sessionNum, opts = {}) {
-  const config = loadConfig();
-  const consecutiveFailures = opts.consecutiveFailures || 0;
-  const projectRoot = assets.projectRoot;
-
-  return assets.render('codingUser', {
-    sessionNum,
-    mcpHint: buildMcpHint(config),
-    retryContext: buildRetryHint(consecutiveFailures, opts.lastValidateLog),
-    envHint: buildEnvHint(consecutiveFailures, sessionNum),
-    testHint: buildTestHint(),
-    docsHint: buildDocsHint(),
-    taskHint: buildTaskHint(projectRoot),
-    testEnvHint: buildTestEnvHint(projectRoot),
-    playwrightAuthHint: buildPlaywrightAuthHint(config),
-    memoryHint: buildMemoryHint(),
-    serviceHint: buildServiceHint(opts.maxSessions || 50),
-  });
-}
-
-// --------------- Scan Session ---------------
-
-function buildScanPrompt(projectType, requirement) {
-  const requirementLine = requirement
-    ? `用户需求概述: ${requirement.slice(0, 500)}`
-    : '';
-
-  return assets.render('scanUser', {
-    projectType,
-    requirement: requirementLine,
-  });
-}
-
-// --------------- Plan Session ---------------
-
-function buildPlanSystemPrompt() {
-  return '你是一个任务分解专家，擅长将模糊需求拆解为结构化、可执行的原子任务。你只分析需求和分解任务，不实现任何代码。';
-}
-
-function buildPlanPrompt(planPath) {
-  const projectRoot = assets.projectRoot;
-  const addGuide = assets.read('addGuide');
-
-  let profileContext = '';
-  const profile = assets.readJson('profile', null);
-  if (profile) {
-    const stack = profile.tech_stack || {};
-    const parts = [];
-    if (stack.backend?.framework) parts.push(`后端: ${stack.backend.framework}`);
-    if (stack.frontend?.framework) parts.push(`前端: ${stack.frontend.framework}`);
-    if (stack.backend?.language) parts.push(`语言: ${stack.backend.language}`);
-    if (parts.length) profileContext = `项目技术栈: ${parts.join(', ')}`;
-  }
-
-  let taskContext = '';
-  let recentExamples = '';
-  try {
-    const taskData = loadTasks();
-    if (taskData) {
-      const stats = getStats(taskData);
-      const features = taskData.features || [];
-      const maxId = features.length ? features[features.length - 1].id : 'feat-000';
-      const maxPriority = features.length ? Math.max(...features.map(f => f.priority || 0)) : 0;
-      const categories = [...new Set(features.map(f => f.category))].join(', ');
-
-      taskContext = `已有 ${stats.total} 个任务（${stats.done} done, ${stats.pending} pending, ${stats.failed} failed）。` +
-        `最大 id: ${maxId}, 最大 priority: ${maxPriority}。已有 category: ${categories}。`;
-
-      const recent = features.slice(-3);
-      if (recent.length) {
-        recentExamples = '已有任务格式参考（保持一致性）：\n' +
-          recent.map(f => `  ${f.id}: "${f.description}" (category=${f.category}, steps=${(f.steps || []).length}步, depends_on=[${(f.depends_on || []).join(',')}])`).join('\n');
-      }
-    }
-  } catch { /* ignore */ }
-
-  let testRuleHint = '';
-  if (assets.exists('testRule') && assets.exists('mcpConfig')) {
-    testRuleHint = '【Playwright 测试规则】项目已配置 Playwright MCP（.mcp.json），' +
-      '`.claude-coder/assets/test_rule.md` 包含测试规范（Smart Snapshot、等待策略、步骤模板等）。端到端测试任务请参考 test_rule.md。';
-  }
-
-  return assets.render('addUser', {
-    profileContext,
-    taskContext,
-    recentExamples,
-    projectRoot,
-    addGuide,
-    testRuleHint,
-    planPath,
-  });
-}
-
-// --------------- Archive Prompt ---------------
-
-function buildArchivePrompt(doneTasks, milestones, tasksPath) {
-  const nextId = String((milestones || []).length + 1).padStart(3, '0');
-  const doneList = doneTasks.map(f => `- ${f.id}: ${f.description}`).join('\n');
-  const existing = milestones && milestones.length > 0
-    ? `已有里程碑示例:\n${JSON.stringify(milestones.slice(-2), null, 2)}`
-    : '目前无已有里程碑';
-
-  return `维护 tasks.json 文件：将已完成任务归档为里程碑。
-
-文件路径: ${tasksPath}
-
-${existing}
-
-需要归档的 ${doneTasks.length} 个 done 任务:
-${doneList}
-
-操作要求:
-1. 在 completed_milestones 数组末尾追加一条记录，格式: { "id": "${nextId}", "summary": "5-20字的精简概述" }
-2. summary 要概括这批任务的核心成果，不要机械拼接描述
-3. 从 features 数组中移除所有 status 为 "done" 的任务
-4. 保持文件中其他字段不变
-5. 用 Write 工具写回 ${tasksPath}`;
-}
-
-// --------------- Exports ---------------
-
-module.exports = {
-  buildSystemPrompt,
-  buildCodingPrompt,
-  buildScanPrompt,
-  buildPlanSystemPrompt,
-  buildPlanPrompt,
-  buildArchivePrompt,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { loadConfig } = require('../common/config');
+const { assets } = require('../common/assets');
+const { loadTasks, getStats } = require('../common/tasks');
+const { loadState, selectNextTask } = require('./harness');
+
+// --------------- System Prompt ---------------
+
+function buildSystemPrompt(type) {
+  const core = assets.read('coreProtocol') || '';
+  let specific = '';
+  switch (type) {
+    case 'scan':    specific = assets.read('scanSystem') || ''; break;
+    case 'coding':  specific = assets.read('codingSystem') || ''; break;
+    case 'plan':    specific = assets.read('planSystem') || ''; break;
+    case 'go':      specific = assets.read('goSystem') || ''; break;
+  }
+  return specific ? `${specific}\n\n${core}` : core;
+}
+
+// --------------- Task Type Detection ---------------
+
+const WEB_CATEGORIES = new Set(['frontend', 'fullstack', 'test', 'e2e']);
+const WEB_KEYWORDS = /playwright|browser|页面|前端|UI|端到端|e2e/i;
+
+function needsWebTools(task) {
+  if (!task) return true;
+  if (WEB_CATEGORIES.has(task.category)) return true;
+  const text = [task.description || '', ...(task.steps || [])].join(' ');
+  return WEB_KEYWORDS.test(text);
+}
+
+// --------------- Hint Builders ---------------
+
+function buildMcpHint(config, task) {
+  if (!config.mcpPlaywright) return '';
+  if (!needsWebTools(task)) return '';
+  return '前端/全栈任务可用 Playwright MCP（browser_navigate、browser_snapshot、browser_click 等）做端到端测试。';
+}
+
+function buildRetryHint(consecutiveFailures, lastValidateLog) {
+  if (consecutiveFailures > 0 && lastValidateLog) {
+    return `注意：上次会话校验失败，原因：${lastValidateLog}。请避免同样的问题。`;
+  }
+  return '';
+}
+
+function buildEnvHint(consecutiveFailures, sessionNum) {
+  if (sessionNum <= 1) return '首次会话，需要时执行 claude-coder init 初始化环境。';
+  if (consecutiveFailures > 0) return '上次失败，建议先确认环境状态。';
+  return '';
+}
+
+function buildDocsHint() {
+  const profile = assets.readJson('profile', null);
+  if (!profile) return '';
+  const docs = profile.existing_docs || [];
+  if (docs.length > 0) {
+    return `项目文档: ${docs.join(', ')}。编码前先读与任务相关的文档，了解接口约定和编码规范。`;
+  }
+  return '';
+}
+
+function buildTaskContext(projectRoot, taskId) {
+  try {
+    const taskData = loadTasks();
+    if (!taskData) return '无法读取 tasks.json，请手动检查。';
+    const features = taskData.features || [];
+    const stats = getStats(taskData);
+
+    const task = taskId
+      ? features.find(f => f.id === taskId)
+      : selectNextTask(taskData);
+
+    if (!task) return '无待处理任务。';
+
+    const steps = (task.steps || [])
+      .map((s, i) => `  ${i + 1}. ${s}`)
+      .join('\n');
+
+    const deps = (task.depends_on || []).length > 0
+      ? `depends_on: [${task.depends_on.join(', ')}]`
+      : '';
+
+    return [
+      `**${task.id}**: "${task.description}"`,
+      `状态: ${task.status}, category: ${task.category}, priority: ${task.priority || 'N/A'} ${deps}`,
+      `步骤:\n${steps}`,
+      `进度: ${stats.done}/${stats.total} done, ${stats.failed} failed`,
+      `项目路径: ${projectRoot}`,
+    ].join('\n');
+  } catch {
+    return '任务上下文加载失败，请读取 .claude-coder/tasks.json 自行确认。';
+  }
+}
+
+function buildTestEnvHint(projectRoot) {
+  if (assets.exists('testEnv')) {
+    return `测试凭证文件: ${projectRoot}/.claude-coder/test.env（含 API Key、测试账号等），测试前用 source 加载。`;
+  }
+  return '';
+}
+
+function buildPlaywrightAuthHint(config, task) {
+  if (!config.mcpPlaywright) return '';
+  if (!needsWebTools(task)) return '';
+  const mode = config.playwrightMode;
+  switch (mode) {
+    case 'persistent':
+      return 'Playwright MCP 使用 persistent 模式，浏览器登录状态持久保存，无需额外登录操作。';
+    case 'isolated':
+      return assets.exists('playwrightAuth')
+        ? 'Playwright MCP 使用 isolated 模式，已检测到登录状态文件，每次会话自动加载。'
+        : 'Playwright MCP 使用 isolated 模式，未检测到登录状态文件。如需登录，请先运行 claude-coder auth <URL>。';
+    case 'extension':
+      return 'Playwright MCP 使用 extension 模式，已连接用户真实浏览器，直接复用已有登录态。';
+    default:
+      return '';
+  }
+}
+
+function buildMemoryHint() {
+  const sr = assets.readJson('sessionResult', null);
+  if (!sr?.session_result) return '';
+  const base = `上次会话 ${sr.session_result}（${sr.status_before || '?'} → ${sr.status_after || '?'}）。`;
+  if (!sr.notes || !sr.notes.trim()) return base;
+  return `${base}遗留: ${sr.notes.slice(0, 200)}`;
+}
+
+function buildServiceHint(maxSessions) {
+  return maxSessions === 1
+    ? '单次模式：收尾时停止所有后台服务。'
+    : '连续模式：收尾时不要停止后台服务，保持服务运行以便下个 session 继续使用。';
+}
+
+// --------------- Context Builders ---------------
+
+function _resolveTask(taskId) {
+  try {
+    const taskData = loadTasks();
+    if (!taskData) return null;
+    const features = taskData.features || [];
+    return taskId ? features.find(f => f.id === taskId) : selectNextTask(taskData);
+  } catch { return null; }
+}
+
+/**
+ * 构建 coding session 的完整上下文（user prompt）
+ */
+function buildCodingContext(sessionNum, opts = {}) {
+  const config = loadConfig();
+  const consecutiveFailures = opts.consecutiveFailures || 0;
+  const projectRoot = assets.projectRoot;
+  const task = _resolveTask(opts.taskId);
+
+  return assets.render('codingUser', {
+    sessionNum,
+    taskContext: buildTaskContext(projectRoot, opts.taskId),
+    mcpHint: buildMcpHint(config, task),
+    retryContext: buildRetryHint(consecutiveFailures, opts.lastValidateLog),
+    envHint: buildEnvHint(consecutiveFailures, sessionNum),
+    docsHint: buildDocsHint(),
+    testEnvHint: buildTestEnvHint(projectRoot),
+    playwrightAuthHint: buildPlaywrightAuthHint(config, task),
+    memoryHint: buildMemoryHint(),
+    serviceHint: buildServiceHint(opts.maxSessions || 50),
+  });
+}
+
+// --------------- Scan Session ---------------
+
+function buildScanPrompt(projectType) {
+  return assets.render('scanUser', { projectType });
+}
+
+// --------------- Plan Session ---------------
+
+function buildPlanPrompt(planPath) {
+  const projectRoot = assets.projectRoot;
+
+  let taskContext = '';
+  let recentExamples = '';
+  try {
+    const taskData = loadTasks();
+    if (taskData) {
+      const features = taskData.features || [];
+      const state = loadState();
+      const nextId = `feat-${String(state.next_task_id).padStart(3, '0')}`;
+      const categories = [...new Set(features.map(f => f.category))].join(', ');
+
+      taskContext = `新任务 ID 从 ${nextId} 开始，priority 从 ${state.next_priority} 开始。已有 category: ${categories || '无'}。`;
+
+      const recent = features.slice(-3);
+      if (recent.length) {
+        recentExamples = '已有任务格式参考（保持一致性）：\n' +
+          recent.map(f => `  ${f.id}: "${f.description}" (category=${f.category}, steps=${(f.steps || []).length}步, depends_on=[${(f.depends_on || []).join(',')}])`).join('\n');
+      }
+    }
+  } catch { /* ignore */ }
+
+  let testRuleHint = '';
+  if (assets.exists('testRule') && assets.exists('mcpConfig')) {
+    testRuleHint = '【Playwright 测试规则】项目已配置 Playwright MCP（.mcp.json），' +
+      '`.claude-coder/assets/test_rule.md` 包含测试规范（Smart Snapshot、等待策略、步骤模板等）。' +
+      '前端页面 test 类任务 steps 首步加入 `【规则】阅读 .claude-coder/assets/test_rule.md`。';
+  }
+
+  return assets.render('planUser', {
+    taskContext,
+    recentExamples,
+    projectRoot,
+    planPath,
+    testRuleHint,
+  });
+}
+
+// --------------- Exports ---------------
+
+module.exports = {
+  buildSystemPrompt,
+  buildCodingContext,
+  buildScanPrompt,
+  buildPlanPrompt,
+};

package/src/core/query.js

@@ -1,48 +1,50 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { buildEnvVars, getAllowedTools } = require('../common/config');
-const { assets } = require('../common/assets');
-
-/**
- * 检查项目是否包含代码文件
- */
-function hasCodeFiles(projectRoot) {
-  const markers = [
-    'package.json', 'pyproject.toml', 'requirements.txt', 'setup.py',
-    'Cargo.toml', 'go.mod', 'pom.xml', 'build.gradle',
-    'Makefile', 'Dockerfile', 'docker-compose.yml',
-    'README.md', 'main.py', 'app.py', 'index.js', 'index.ts',
-  ];
-  for (const m of markers) {
-    if (fs.existsSync(path.join(projectRoot, m))) return true;
-  }
-  for (const d of ['src', 'lib', 'app', 'backend', 'frontend', 'web', 'server', 'client']) {
-    if (fs.existsSync(path.join(projectRoot, d)) && fs.statSync(path.join(projectRoot, d)).isDirectory()) return true;
-  }
-  return false;
-}
-
-/**
- * 构建 SDK query 选项
- */
-function buildQueryOptions(config, opts = {}) {
-  const base = {
-    allowedTools: getAllowedTools(config),
-    permissionMode: 'bypassPermissions',
-    allowDangerouslySkipPermissions: true,
-    cwd: opts.projectRoot || assets.projectRoot,
-    env: buildEnvVars(config),
-    settingSources: ['project'],
-  };
-  if (config.maxTurns > 0) base.maxTurns = config.maxTurns;
-  if (opts.model) base.model = opts.model;
-  else if (config.model) base.model = config.model;
-  return base;
-}
-
-module.exports = {
-  hasCodeFiles,
-  buildQueryOptions,
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { buildEnvVars } = require('../common/config');
+const { assets } = require('../common/assets');
+
+/**
+ * 检查项目是否包含代码文件
+ */
+function hasCodeFiles(projectRoot) {
+  const markers = [
+    'package.json', 'pyproject.toml', 'requirements.txt', 'setup.py',
+    'Cargo.toml', 'go.mod', 'pom.xml', 'build.gradle',
+    'Makefile', 'Dockerfile', 'docker-compose.yml',
+    'README.md', 'main.py', 'app.py', 'index.js', 'index.ts',
+  ];
+  for (const m of markers) {
+    if (fs.existsSync(path.join(projectRoot, m))) return true;
+  }
+  for (const d of ['src', 'lib', 'app', 'backend', 'frontend', 'web', 'server', 'client']) {
+    if (fs.existsSync(path.join(projectRoot, d)) && fs.statSync(path.join(projectRoot, d)).isDirectory()) return true;
+  }
+  return false;
+}
+
+/**
+ * 构建 SDK query 选项
+ */
+function buildQueryOptions(config, opts = {}) {
+  const mode = opts.permissionMode || 'bypassPermissions';
+  const base = {
+    permissionMode: mode,
+    cwd: opts.projectRoot || assets.projectRoot,
+    env: buildEnvVars(config),
+    settingSources: ['project'],
+  };
+  if (mode === 'bypassPermissions') {
+    base.allowDangerouslySkipPermissions = true;
+  }
+  if (config.maxTurns > 0) base.maxTurns = config.maxTurns;
+  if (opts.model) base.model = opts.model;
+  else if (config.model) base.model = config.model;
+  return base;
+}
+
+module.exports = {
+  hasCodeFiles,
+  buildQueryOptions,
 };