refactor(agents): 四个存量 system agent 按 27-NAMING §3.4 归位

命名轴是「节点在哪一层图里」，把散落的老 agent 归到它实际所处的层级： innovator → org-innovator type='cxo'，是 org graph 层的节点 hunter → innovator-hunt innovator work graph 第 1 阶段 digester → innovator-digest 第 2 阶段（输入是 hunt 产出） evolver → innovator-evolver 第 3 阶段依据：retrain-pipeline.js 的 stepConfigs 就是按 hunter → digester → evolver 顺序跑的，行 231 明写 steps: ['re_hunt','re_digest','evolve'] —— 这三个本来就是 innovator 的 work graph 三阶段，只是名字没体现出来。 ■ 迁移（scripts/migrate-agent-naming.js，--dry-run + 幂等可重跑） - 8 个目录（system/agents/ + system/templates/），用 git mv 保留历史 - system_agents 表 4 行的 id 与 legacy_path - 公司实例目录与 company.json.agents[]（本次无公司雇过这四个，实际 0 条） ■ 代码引用点（5 处，手工改） - retrain-pipeline.js: stepConfigs 的 agent 字段 ×3、agentToStep 映射的 key ×3、 call_sub_agent 的 evolver 判断 - agent-chat.js: agent 列表过滤里的 innovator - company.js: 模板训练触发的 agentId ■ 刻意不动的三类同形异义（改了会坏） 1. skill 内部子目录名 {skillDir}/hunter/knowhow.md —— 那是 hunt/digest/evolve 三阶段的产物目录约定，与 agent 名同形但不同义。涉及 open-api.js:402、 retrain-pipeline.js:148/374、evolution-loop.js:178、sync-skills.js 的 INTERNAL_DIRS 2. skill 命名空间白名单 —— skill-dir-manager.js 的 CORE_SKILLS、 migrate-trained-skills.js 的 SYSTEM_SKILLS，那里的 'innovator' 指同名 skill 3. conversations/ 与 system/tasklog/ 下的历史记录 —— 运行态数据，不改写历史 evolver-youtube-crawler 按 §3.4 列为待定，迁移脚本按精确目录名匹配，未误伤。这四个重命名顺带解决了 27 号文档 §七挂了很久的 6 个命名冲突 id —— 重命名后 system/agents/ 与 system/templates/ 下不再有同名目录（只剩 agent-creator 与 evolver-youtube-crawler 两个，前者是基础设施角色按规则不改名）。验证：npm run test:unit 693 全绿（64 files）；test-company-e2e 114/114；迁移脚本二次执行 dirs=0 dbRows=0 skipped=8（幂等）。未触碰另一进程正在进行的 P3 文件（graph-engine.js / graph-run-sse.js / work-graph-db.js / 27-p3-p4-work-graph-console.md / 27-requirement.md）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

refactor(agents): 四个存量 system agent 按 27-NAMING §3.4 归位
命名轴是「节点在哪一层图里」，把散落的老 agent 归到它实际所处的层级： innovator → org-innovator type='cxo'，是 org graph 层的节点 hunter → innovator-hunt innovator work graph 第 1 阶段 digester → innovator-digest 第 2 阶段（输入是 hunt 产出） evolver → innovator-evolver 第 3 阶段依据：retrain-pipeline.js 的 stepConfigs 就是按 hunter → digester → evolver 顺序跑的，行 231 明写 steps: ['re_hunt','re_digest','evolve'] —— 这三个本来就是 innovator 的 work graph 三阶段，只是名字没体现出来。 ■ 迁移（scripts/migrate-agent-naming.js，--dry-run + 幂等可重跑） - 8 个目录（system/agents/ + system/templates/），用 git mv 保留历史 - system_agents 表 4 行的 id 与 legacy_path - 公司实例目录与 company.json.agents[]（本次无公司雇过这四个，实际 0 条） ■ 代码引用点（5 处，手工改） - retrain-pipeline.js: stepConfigs 的 agent 字段 ×3、agentToStep 映射的 key ×3、 call_sub_agent 的 evolver 判断 - agent-chat.js: agent 列表过滤里的 innovator - company.js: 模板训练触发的 agentId ■ 刻意不动的三类同形异义（改了会坏） 1. skill 内部子目录名 {skillDir}/hunter/knowhow.md —— 那是 hunt/digest/evolve 三阶段的产物目录约定，与 agent 名同形但不同义。涉及 open-api.js:402、 retrain-pipeline.js:148/374、evolution-loop.js:178、sync-skills.js 的 INTERNAL_DIRS 2. skill 命名空间白名单 —— skill-dir-manager.js 的 CORE_SKILLS、 migrate-trained-skills.js 的 SYSTEM_SKILLS，那里的 'innovator' 指同名 skill 3. conversations/ 与 system/tasklog/ 下的历史记录 —— 运行态数据，不改写历史 evolver-youtube-crawler 按 §3.4 列为待定，迁移脚本按精确目录名匹配，未误伤。这四个重命名顺带解决了 27 号文档 §七挂了很久的 6 个命名冲突 id —— 重命名后 system/agents/ 与 system/templates/ 下不再有同名目录（只剩 agent-creator 与 evolver-youtube-crawler 两个，前者是基础设施角色按规则不改名）。验证：npm run test:unit 693 全绿（64 files）；test-company-e2e 114/114；迁移脚本二次执行 dirs=0 dbRows=0 skipped=8（幂等）。未触碰另一进程正在进行的 P3 文件（graph-engine.js / graph-run-sse.js / work-graph-db.js / 27-p3-p4-work-graph-console.md / 27-requirement.md）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
yibo
1 parent c3abf4a9
Showing 138 changed files with 176 additions and 10 deletions
docs/todo/system-design/27-naming-conventions.md
scripts/migrate-agent-naming.js
server/routes/agent-chat.js
server/routes/company.js
server/services/retrain-pipeline.js
system/agents/digester/agent.md → system/agents/innovator-digest/agent.md
system/agents/digester/config.json → system/agents/innovator-digest/config.json
system/agents/digester/heartbeat.md → system/agents/innovator-digest/heartbeat.md
system/agents/digester/identity.md → system/agents/innovator-digest/identity.md
system/agents/digester/plan.md → system/agents/innovator-digest/plan.md
system/agents/digester/soul.md → system/agents/innovator-digest/soul.md
system/agents/digester/todo.md → system/agents/innovator-digest/todo.md
system/agents/digester/tools.md → system/agents/innovator-digest/tools.md
system/agents/digester/user.md → system/agents/innovator-digest/user.md
system/agents/evolver/agent.md → system/agents/innovator-evolver/agent.md
system/agents/evolver/config.json → system/agents/innovator-evolver/config.json
system/agents/evolver/debug_rubric.js → system/agents/innovator-evolver/debug_rubric.js
system/agents/evolver/heartbeat.md → system/agents/innovator-evolver/heartbeat.md
system/agents/evolver/identity.md → system/agents/innovator-evolver/identity.md
system/agents/evolver/soul.md → system/agents/innovator-evolver/soul.md
@@ -110,7 +110,17 @@ ops.json      org-planner → org-monitor → org-validator
 - `agent-creator`：与 `orggraph-planning` 同属**基础设施角色**，不是任何图上的节点，不加前缀，保持原名。
 - `evolver-youtube-crawler`：针对单个 skill 特化的 evolver 实例，按规则应为 `innovator-evolver-youtube-crawler`，名字过长且疑似一次性产物，**待定**，暂不改名。
-> ⚠️ §3.4 的四个重命名**尚未落到代码**，需要一次迁移（目录改名 + `system_agents` 表 + `retrain-pipeline.js` 等引用点）。§3.1-3.3 的新命名已应用于文档与 `system/org-graph-templates/`。
+> ✅ §3.4 的四个重命名**已落到代码**（`scripts/migrate-agent-naming.js`，幂等可重跑）：
+> 8 个目录（`system/agents/` + `system/templates/`）、`system_agents` 表 4 行、
+> 以及 5 处代码引用点（`retrain-pipeline.js` 的 `agent:` 字段 / `agentToStep` 映射 /
+> `call_sub_agent` 判断、`agent-chat.js` 的 agent 列表过滤、`company.js` 的训练触发）。
+>
+> **迁移时明确不动的东西**（改了会坏）：
+> - skill 内部子目录名 `{skillDir}/hunter/knowhow.md` —— 那是 hunt/digest/evolve
+>   三阶段的**产物目录**约定，与 agent 名同形但不同义
+> - skill 命名空间的白名单（`skill-dir-manager.js` 的 `CORE_SKILLS`、
+>   `migrate-trained-skills.js` 的 `SYSTEM_SKILLS`）—— 那里的 `innovator` 指同名 skill
+> - `conversations/` 与 `system/tasklog/` 下的历史记录 —— 运行态数据，不改写历史
 ### 3.5 归因类节点 —— `validator-reflection`（R-16，两处待定案）
+#!/usr/bin/env node
+/**
+ * migrate-agent-naming.js — 存量 system agent 按 27-NAMING §3.4 归位
+ *
+ * 依据: docs/todo/system-design/27-naming-conventions.md §3.4（R-15.3 定案）
+ * 命名轴是「节点在哪一层图里」，把散落的老 agent 归到它实际所处的层级：
+ *
+ *   innovator → org-innovator       type='cxo'，是 org graph 层的节点
+ *   hunter    → innovator-hunt      retrain-pipeline.js:161，innovator work graph 第 1 阶段
+ *   digester  → innovator-digest    同上第 2 阶段（行 179，输入是 hunter 产出）
+ *   evolver   → innovator-evolver   同上第 3 阶段（行 196）
+ *
+ * 迁移内容:
+ *   目录  system/agents/{旧}/     → system/agents/{新}/
+ *         system/templates/{旧}/  → system/templates/{新}/
+ *   DB    system_agents 的 id 与 legacy_path
+ *   实例  data/companies/*\/agents/{旧}/ 与 company.json.agents[]（若有公司雇过）
+ *
+ * ⚠️ 明确不动的东西（改了会坏）:
+ *   - skill 内部子目录名 `{skillDir}/hunter/knowhow.md` —— 那是 hunt/digest/evolve
+ *     三阶段的产物目录约定，不是 agent 名（open-api.js:402、retrain-pipeline.js:148/374、
+ *     evolution-loop.js:178、sync-skills.js:62 的 INTERNAL_DIRS 等）
+ *   - skill 命名空间的白名单 —— skill-dir-manager.js 的 CORE_SKILLS、
+ *     migrate-trained-skills.js 的 SYSTEM_SKILLS，那里的 'innovator' 指的是同名 skill
+ *   - `evolver-youtube-crawler` —— 27-NAMING §3.4 列为待定，按精确目录名匹配，不会误伤
+ *   - conversations/ 与 system/tasklog/ 下的历史记录 —— 运行态数据，不改写历史
+ *
+ * 用法:
+ *   node scripts/migrate-agent-naming.js --dry-run
+ *   node scripts/migrate-agent-naming.js
+ *
+ * 幂等: 已迁移过（新名存在且旧名不存在）会被跳过，可重复执行。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const DRY = process.argv.includes('--dry-run');
+
+/** 旧名 → 新名。顺序无关，全部按精确名匹配，不做前缀/正则匹配。 */
+const RENAMES = {
+  innovator: 'org-innovator',
+  hunter: 'innovator-hunt',
+  digester: 'innovator-digest',
+  evolver: 'innovator-evolver',
+};
+
+const log = (...a) => console.log(DRY ? '[dry-run]' : '[migrate]', ...a);
+const stats = { dirs: 0, dbRows: 0, companyInstances: 0, skipped: 0 };
+
+/** 用 git mv 保留历史；不在 git 索引里的目录退回 fs.renameSync */
+function moveDir(from, to) {
+  if (DRY) return;
+  try {
+    execFileSync('git', ['mv', from, to], { cwd: ROOT, stdio: 'pipe' });
+  } catch {
+    fs.renameSync(path.join(ROOT, from), path.join(ROOT, to));
+  }
+}
+
+function migrateDirs() {
+  for (const [oldName, newName] of Object.entries(RENAMES)) {
+    for (const base of ['system/agents', 'system/templates']) {
+      const from = `${base}/${oldName}`;
+      const to = `${base}/${newName}`;
+      const fromAbs = path.join(ROOT, from);
+      const toAbs = path.join(ROOT, to);
+
+      if (!fs.existsSync(fromAbs)) {
+        if (fs.existsSync(toAbs)) { stats.skipped++; }   // 已迁移过
+        continue;
+      }
+      if (fs.existsSync(toAbs)) {
+        log(`⚠️  跳过（新旧同时存在，需人工处理）: ${from} / ${to}`);
+        stats.skipped++;
+        continue;
+      }
+      log(`目录: ${from} → ${to}`);
+      moveDir(from, to);
+      stats.dirs++;
+    }
+  }
+}
+
+function migrateDb() {
+  const { getDb } = require(path.join(ROOT, 'server/services/graph-db'));
+  const db = getDb();
+  const sel = db.prepare('SELECT id, legacy_path FROM system_agents WHERE id = ?');
+  const upd = db.prepare('UPDATE system_agents SET id = ?, legacy_path = ?, updated_at = ? WHERE id = ?');
+  const now = new Date().toISOString();
+
+  const tx = db.transaction(() => {
+    for (const [oldName, newName] of Object.entries(RENAMES)) {
+      const row = sel.get(oldName);
+      if (!row) continue;
+      const newPath = (row.legacy_path || '').replace(
+        new RegExp(`(^|/)${oldName}$`), `$1${newName}`
+      );
+      log(`DB: system_agents ${oldName} → ${newName}（legacy_path: ${row.legacy_path} → ${newPath}）`);
+      if (!DRY) upd.run(newName, newPath, now, oldName);
+      stats.dbRows++;
+    }
+  });
+  tx();
+}
+
+/** 有公司雇过这四个的话，同步改私有目录名与 company.json.agents[] */
+function migrateCompanyInstances() {
+  const companiesDir = path.join(ROOT, 'data/companies');
+  if (!fs.existsSync(companiesDir)) return;
+
+  for (const d of fs.readdirSync(companiesDir, { withFileTypes: true })) {
+    if (!d.isDirectory()) continue;
+    const cid = d.name;
+
+    for (const [oldName, newName] of Object.entries(RENAMES)) {
+      const from = path.join(companiesDir, cid, 'agents', oldName);
+      const to = path.join(companiesDir, cid, 'agents', newName);
+      if (!fs.existsSync(from) || fs.existsSync(to)) continue;
+      log(`实例: ${cid}/agents/${oldName} → ${newName}`);
+      if (!DRY) fs.renameSync(from, to);
+      stats.companyInstances++;
+    }
+
+    const cjPath = path.join(companiesDir, cid, 'company.json');
+    if (!fs.existsSync(cjPath)) continue;
+    let cj;
+    try { cj = JSON.parse(fs.readFileSync(cjPath, 'utf-8')); } catch { continue; }
+    if (!Array.isArray(cj.agents)) continue;
+
+    const next = cj.agents.map(a => RENAMES[a] || a);
+    if (JSON.stringify(next) !== JSON.stringify(cj.agents)) {
+      log(`实例: ${cid}/company.json agents[] 已更新`);
+      if (!DRY) {
+        cj.agents = next;
+        fs.writeFileSync(cjPath, JSON.stringify(cj, null, 2) + '\n', 'utf-8');
+      }
+    }
+  }
+}
+
+function main() {
+  log(DRY ? '=== DRY RUN（不写盘）===' : '=== 开始迁移 ===');
+  migrateDirs();
+  migrateDb();
+  migrateCompanyInstances();
+  console.log('\n' + (DRY ? '[dry-run] ' : '') + '汇总:', JSON.stringify(stats));
+  if (DRY) console.log('这是 dry-run，未做任何改动。去掉 --dry-run 实际执行。');
+  else console.log('完成。代码引用点（retrain-pipeline.js / agent-chat.js / company.js）需另行修改，见 27-NAMING §3.4。');
+}
+
+if (require.main === module) main();
+
+module.exports = { RENAMES };
@@ -324,7 +324,7 @@ function buildSystemPrompt(agentDir, userMessage) {
   // ── Layer 3: Agent 专属文件 ──
   const agentListText = Object.entries(fullSystemConfig.agents || {})
-    .filter(([name]) => name !== 'master' && name !== 'innovator')
+    .filter(([name]) => name !== 'master' && name !== 'org-innovator')
     .map(([name, cfg]) => {
       const typeLabel = cfg.type === 'orchestrator' ? '子编排' : cfg.type;
       return `- ${name} (${typeLabel}): ${cfg.description || ''}`;
@@ -522,7 +522,7 @@ router.get(&#39;/templates/:templateId/logs&#39;, (req, res) =&gt; {
     // 扫描 agent-creator 和 innovator 的对话，匹配 tpl-gen-{id} 和 tpl-train-{id}
     const scanAgents = [
       { agentId: 'agent-creator', prefix: `tpl-gen-${templateId}`, type: 'generate', label: '🤖 Agent Creator' },
-      { agentId: 'innovator', prefix: `tpl-train-${templateId}`, type: 'train', label: '🎓 Innovator' },
+      { agentId: 'org-innovator', prefix: `tpl-train-${templateId}`, type: 'train', label: '🎓 Innovator' },
     ];
     for (const scan of scanAgents) {
@@ -158,7 +158,7 @@ class RetrainPipeline {
         label: '🔍 Step 1/3: ReHunt',
         jobStatus: 'hunting',
         jobProgress: '正在猎取领域知识 (Hunt)...',
-        agent: 'hunter',
+        agent: 'innovator-hunt',
         prompt: [
           `请对 Skill "${this.skillName}" 重新猎取领域知识：`,
           `- Skill 描述: ${this.skill.description || '无'}`,
@@ -176,7 +176,7 @@ class RetrainPipeline {
         label: '📝 Step 2/3: ReDigest',
         jobStatus: 'digesting',
         jobProgress: '正在消化提炼知识 (Digest)...',
-        agent: 'digester',
+        agent: 'innovator-digest',
         prompt: [
           `请对 Skill "${this.skillName}" 重新消化并更新评估基准：`,
           `- 更新后的知识: ${this.skillName}/hunter/knowhow.md`,
@@ -193,7 +193,7 @@ class RetrainPipeline {
         label: '🔄 Step 3/3: Evolve',
         jobStatus: 'evolving',
         jobProgress: '进化优化中 (目标 ≥95分)...',
-        agent: 'evolver',
+        agent: 'innovator-evolver',
         prompt: [
           `请对 Skill "${this.skillName}" 进行进化优化：`,
           `- skillName: ${this.skillName}`,
@@ -440,9 +440,9 @@ class RetrainPipeline {
           // 同步 checkpoint — 当 Master 调用 call_sub_agent 时更新
           if (tc.tool === 'call_sub_agent') {
             const agentToStep = {
-              'hunter': 're_hunt',
-              'digester': 're_digest',
-              'evolver': 'evolve',
+              'innovator-hunt': 're_hunt',
+              'innovator-digest': 're_digest',
+              'innovator-evolver': 'evolve',
             };
             const step = agentToStep[tc.params?.agent];
             if (step) {
@@ -469,7 +469,7 @@ class RetrainPipeline {
       // 也检查 tool call 结果中的分数
       if (!finalScore && result.toolCalls) {
         for (const tc of result.toolCalls) {
-          if (tc.tool === 'call_sub_agent' && tc.params?.agent === 'evolver') {
+          if (tc.tool === 'call_sub_agent' && tc.params?.agent === 'innovator-evolver') {
             const evolveOutput = tc.result?.output || '';
             const sm = evolveOutput.match(/最终分数[：:]\s*(\d+)/);
             if (sm) finalScore = parseInt(sm[1]);