@yeaft/webchat-agent 0.0.174 → 0.0.176

package/crew.js

@@ -327,8 +327,7 @@ async function saveSessionMeta(session) {
     costUsd: session.costUsd,
     totalInputTokens: session.totalInputTokens,
     totalOutputTokens: session.totalOutputTokens,
-    features: Array.from(session.features.values()),
-    groupNames: session.groupNames || {}
+    features: Array.from(session.features.values())
   };
   await fs.writeFile(join(session.sharedDir, 'session.json'), JSON.stringify(meta, null, 2));
   // 保存 UI 消息历史（用于恢复时重放）
@@ -549,7 +548,6 @@ export async function resumeCrewSession(msg) {
     waitingHumanContext: null,
     pendingRoutes: [],
     features: new Map((meta.features || []).map(f => [f.taskId, f])),
-    groupNames: meta.groupNames || {},
     userId: userId || meta.userId,
     username: username || meta.username,
     agentId: meta.agentId || ctx.CONFIG?.agentName || null,
@@ -671,20 +669,6 @@ export async function createCrewSession(msg) {
     }
   }
 
-  // 生成组名
-  const groupNames = {};
-  const maxGroup = Math.max(0, ...roles.map(r => r.groupIndex || 0));
-  for (let g = 1; g <= maxGroup; g++) {
-    const members = roles.filter(r => r.groupIndex === g);
-    const hasRev = members.some(r => r.roleType === 'reviewer');
-    const hasTest = members.some(r => r.roleType === 'tester');
-    if (hasRev && hasTest) {
-      groupNames[g] = maxGroup > 1 ? `全栈开发组 ${g}` : '全栈开发组';
-    } else {
-      groupNames[g] = maxGroup > 1 ? `开发组 ${g}` : '开发组';
-    }
-  }
-
   // 找到决策者
   const decisionMaker = roles.find(r => r.isDecisionMaker)?.name || roles[0]?.name || null;
 
@@ -710,7 +694,6 @@ export async function createCrewSession(msg) {
     waitingHumanContext: null, // { fromRole, reason, message }
     pendingRoutes: [],        // [{ fromRole, route }] — 暂停时未完成的路由
     features: new Map(),      // taskId → { taskId, taskTitle, createdAt } — 持久化 feature 列表
-    groupNames,               // groupIndex → 组名
     userId,
     username,
     agentId: ctx.CONFIG?.agentName || null,
@@ -740,7 +723,6 @@ export async function createCrewSession(msg) {
     })),
     decisionMaker,
     maxRounds,
-    groupNames,
     userId,
     username
   });
@@ -1003,6 +985,50 @@ ${roles.length > 0 ? roles.map(r => `- ${roleLabel(r)}(${r.name}): ${r.descripti
 - PM 不做 cherry-pick，只负责打 tag
 - 每次新任务/新 feature 必须基于最新的 main 分支创建新的 worktree，确保在最新代码上开发
 
+# Feature 进度管理
+每个 Feature 使用独立的进度文件来跟踪状态，存放在 context/features/ 目录下。
+
+## 文件命名规范
+- 文件名格式: \`context/features/{task-id}.md\`（如 \`context/features/task-1.md\`）
+- 由 PM 在分配任务时指示 developer 创建初始文件
+
+## 文件格式
+\`\`\`markdown
+# Feature: {taskTitle}
+- task-id: {task-id}
+- 状态: 待开发 | 开发中 | 待审查 | 审查中 | 已完成 | 已阻塞
+- 负责人: {dev角色name}
+- 审查者: {reviewer角色name}
+- 测试者: {tester角色name}
+- 创建时间: {ISO时间}
+
+## 需求描述
+{PM写的需求}
+
+## 实现记录
+_由开发者填写_
+
+## 审查记录
+_由审查者填写_
+
+## 测试记录
+_由测试者填写_
+\`\`\`
+
+## 状态流转规则
+1. PM 创建文件 → 状态「待开发」
+2. dev 开始工作 → 更新为「开发中」，填写实现方案
+3. dev 完成 → 更新为「待审查」，记录改动摘要（reviewer 和 tester 并行工作）
+4. reviewer/tester 开始工作 → 更新为「审查中」，各自填写审查/测试记录
+5. 发现问题需返工 → 更新回「开发中」
+6. 全部通过 → PM 更新为「已完成」
+
+## 角色职责
+- **PM**: 规划 feature 文件（通过 ROUTE 让 dev 创建），填写需求描述，最终标记完成
+- **Developer**: 更新开发状态，填写「实现记录」（方案、改动文件、注意事项）
+- **Reviewer**: 填写「审查记录」（评分、问题列表、是否通过）
+- **Tester**: 填写「测试记录」（测试用例、结果、发现的 Bug）
+
 ${sharedMemoryContent}`;
 
   await fs.writeFile(join(sharedDir, 'CLAUDE.md'), claudeMd);
@@ -1243,19 +1269,12 @@ ${routeTargets.map(r => `- ${r.name}: ${roleLabel(r)} — ${r.description}`).joi
   // 决策者额外 prompt
   if (role.isDecisionMaker) {
 
-    prompt += `\n\n# 工具使用限制（绝对禁令）
-你**绝对不能**使用以下工具修改任何文件：
-- Edit 工具 — 禁止
-- Write 工具 — 禁止
-- NotebookEdit 工具 — 禁止
-
-你**可以**使用的工具：
-- Read — 读取文件内容
-- Grep — 搜索代码
-- Glob — 查找文件
-- Bash — 仅限 git 命令（git status/add/commit/push/tag/log/diff）和只读命令
+    prompt += `\n\n# 工具使用规则
+你**不能**使用 Edit/Write/NotebookEdit 工具修改代码文件（.js/.ts/.jsx/.tsx/.css/.html/.vue/.py/.go/.rs/.java/.c/.cpp/.h/.rb/.php/.swift/.kt 等源代码文件）。
+你**可以**使用这些工具修改文档和配置文件（.md/.json/.yaml/.yml/.toml/.txt/.env/.gitignore 等非代码文件）。
+你**可以**使用：Read、Grep、Glob、Bash（git 命令和只读命令）。
 
-如果你需要修改任何文件（无论多小的改动），必须 ROUTE 给 developer 执行。`;
+代码改动必须 ROUTE 给 developer 执行。文档和配置可以自己改。`;
 
     prompt += `\n\n# 决策者职责
 你是团队的决策者。其他角色遇到不确定的情况会请求你的决策。
@@ -1340,6 +1359,47 @@ summary: 请实现注册页面，包括邮箱验证
 - TASKS 块不需要在回复最末尾，可以放在任意位置`;
   }
 
+  // Feature 进度记录要求（按角色类型注入）
+  if (role.isDecisionMaker) {
+    prompt += `\n\n# Feature 进度文件管理
+当你分配任务时，需要确保对应的 feature 进度文件被创建：
+1. 文件路径: \`context/features/{task-id}.md\`（如 \`context/features/task-1.md\`）
+2. 使用共享 CLAUDE.md 中定义的文件格式，填写需求描述
+3. 初始状态设为「待开发」
+4. 所有子任务完成后，通过 ROUTE 让 dev 将状态更新为「已完成」
+
+因为你不能使用 Write/Edit 工具，feature 文件的创建和更新都通过 ROUTE 给 developer 执行。在 ROUTE 的 summary 中明确要求 dev 创建/更新 feature 文件，并提供需求描述内容。`;
+  } else if (role.roleType === 'developer') {
+    prompt += `\n\n# Feature 进度记录
+收到任务后，你必须维护 feature 进度文件 \`context/features/{task-id}.md\`：
+1. 如果 PM 要求创建 feature 文件，先创建它（确保 context/features/ 目录存在）
+2. 开始开发时：将状态更新为「开发中」
+3. 开发完成时：将状态更新为「待审查」，在「实现记录」中填写：
+   - 实现方案概述
+   - 修改的文件列表
+   - 需要注意的事项
+4. 收到审查/测试反馈需要修改时：将状态更新回「开发中」，追加修改记录`;
+  } else if (role.roleType === 'reviewer') {
+    prompt += `\n\n# Feature 进度记录
+完成代码审查后，你必须更新 feature 进度文件 \`context/features/{task-id}.md\`：
+1. 在「审查记录」中填写：
+   - 代码质量评分（10分制）
+   - 发现的问题列表（如有）
+   - 审查结论（通过/需修改）
+2. 如果审查通过：不修改状态（等测试也通过后由 PM 标记完成）
+3. 如果需要修改：将状态更新为「开发中」`;
+  } else if (role.roleType === 'tester') {
+    prompt += `\n\n# Feature 进度记录
+完成测试后，你必须更新 feature 进度文件 \`context/features/{task-id}.md\`：
+1. 在「测试记录」中填写：
+   - 测试用例列表及结果
+   - 发现的 Bug（如有）
+   - 测试结论（通过/不通过）
+2. 如果测试通过：不修改状态（等审查也通过后由 PM 标记完成）
+3. 如果发现 Bug：将状态更新为「开发中」`;
+  }
+  // designer 等其他角色不需要维护 feature 进度文件，无需注入额外 prompt
+
   // 执行者角色的组绑定 prompt（count > 1 时）
   if (role.groupIndex > 0 && role.roleType === 'developer') {
     const gi = role.groupIndex;
@@ -2680,8 +2740,7 @@ function sendStatusUpdate(session) {
         .filter(([, s]) => s.turnActive && s.currentTool)
         .map(([name, s]) => [name, s.currentTool])
     ),
-    features: Array.from(session.features.values()),
-    groupNames: session.groupNames || {}
+    features: Array.from(session.features.values())
   });
 
   // 异步更新持久化

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.0.174",
+  "version": "0.0.176",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",