@colin4k1024/tsp 2.4.5 → 2.4.7

package/scripts/lib/install-targets/codex-home.js

@@ -1,4 +1,189 @@
-const { createInstallTargetAdapter } = require('./helpers');
+const fs = require('fs');
+const path = require('path');
+
+const {
+  createInstallTargetAdapter,
+  createManagedOperation,
+  normalizeRelativePath,
+} = require('./helpers');
+
+const PLUGIN_NAME = require('../team-skills-data.json').plugin.name;
+
+function addOperation(operations, seen, operation) {
+  const key = `${operation.sourceRelativePath}=>${operation.destinationPath}`;
+  if (seen.has(key)) {
+    return;
+  }
+  seen.add(key);
+  operations.push(operation);
+}
+
+function addCopyOperation(operations, seen, moduleId, sourceRelativePath, destinationPath, strategy = 'preserve-relative-path') {
+  addOperation(operations, seen, createManagedOperation({
+    moduleId,
+    sourceRelativePath,
+    destinationPath,
+    strategy,
+  }));
+}
+
+function sourceDir(input, sourceRelativePath) {
+  return path.join(input.repoRoot || '', normalizeRelativePath(sourceRelativePath));
+}
+
+function rootAgentFileName(sourcePath, fileName) {
+  const normalizedSourcePath = normalizeRelativePath(sourcePath);
+  if (normalizedSourcePath === 'agents/specialists' || normalizedSourcePath.startsWith('agents/specialists/')) {
+    return `specialist-${fileName}`;
+  }
+  return fileName;
+}
+
+function addRootSkillOperations(operations, seen, moduleId, sourceRelativePath, input, targetRoot) {
+  const normalizedSourcePath = normalizeRelativePath(sourceRelativePath);
+  if (!normalizedSourcePath.startsWith('skills/')) {
+    return;
+  }
+
+  const absoluteSourceDir = sourceDir(input, normalizedSourcePath);
+  if (!input.repoRoot || !fs.existsSync(absoluteSourceDir) || !fs.statSync(absoluteSourceDir).isDirectory()) {
+    return;
+  }
+
+  if (fs.existsSync(path.join(absoluteSourceDir, 'SKILL.md'))) {
+    addCopyOperation(
+      operations,
+      seen,
+      moduleId,
+      normalizedSourcePath,
+      path.join(targetRoot, 'skills', path.basename(normalizedSourcePath)),
+      'flatten-skill-copy'
+    );
+    return;
+  }
+
+  for (const entry of fs.readdirSync(absoluteSourceDir, { withFileTypes: true }).sort((left, right) => (
+    left.name.localeCompare(right.name)
+  ))) {
+    const nestedSourcePath = path.join(normalizedSourcePath, entry.name);
+    const nestedAbsolutePath = path.join(absoluteSourceDir, entry.name);
+    if (entry.isDirectory() && fs.existsSync(path.join(nestedAbsolutePath, 'SKILL.md'))) {
+      addCopyOperation(
+        operations,
+        seen,
+        moduleId,
+        nestedSourcePath,
+        path.join(targetRoot, 'skills', entry.name),
+        'flatten-skill-copy'
+      );
+    }
+  }
+}
+
+function addRootAgentOperations(operations, seen, moduleId, sourceRelativePath, input, targetRoot) {
+  const normalizedSourcePath = normalizeRelativePath(sourceRelativePath);
+  if (normalizedSourcePath !== 'agents' && !normalizedSourcePath.startsWith('agents/')) {
+    return;
+  }
+
+  const agentDirs = normalizedSourcePath === 'agents'
+    ? ['roles', 'specialists']
+    : [''];
+
+  for (const agentDir of agentDirs) {
+    const sourcePath = agentDir ? path.join(normalizedSourcePath, agentDir) : normalizedSourcePath;
+    const absoluteSourceDir = sourceDir(input, sourcePath);
+    if (!input.repoRoot || !fs.existsSync(absoluteSourceDir)) {
+      continue;
+    }
+
+    const stat = fs.statSync(absoluteSourceDir);
+    if (stat.isFile() && path.extname(absoluteSourceDir) === '.md') {
+      const fileName = rootAgentFileName(path.dirname(sourcePath), path.basename(sourcePath));
+      addCopyOperation(
+        operations,
+        seen,
+        moduleId,
+        sourcePath,
+        path.join(targetRoot, 'agents', fileName),
+        'flatten-agent-copy'
+      );
+      continue;
+    }
+
+    if (!stat.isDirectory()) {
+      continue;
+    }
+
+    for (const entry of fs.readdirSync(absoluteSourceDir, { withFileTypes: true }).sort((left, right) => (
+      left.name.localeCompare(right.name)
+    ))) {
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        const fileName = rootAgentFileName(sourcePath, entry.name);
+        addCopyOperation(
+          operations,
+          seen,
+          moduleId,
+          path.join(sourcePath, entry.name),
+          path.join(targetRoot, 'agents', fileName),
+          'flatten-agent-copy'
+        );
+      }
+    }
+  }
+}
+
+function planCodexOperations(input, adapter) {
+  const targetRoot = adapter.resolveRoot(input);
+  const pluginRoot = path.join(targetRoot, 'plugins', PLUGIN_NAME);
+  const operations = [];
+  const seen = new Set();
+
+  for (const module of Array.isArray(input.modules) ? input.modules : []) {
+    for (const rawSourcePath of Array.isArray(module.paths) ? module.paths : []) {
+      const sourceRelativePath = normalizeRelativePath(rawSourcePath);
+
+      addCopyOperation(
+        operations,
+        seen,
+        module.id,
+        sourceRelativePath,
+        path.join(pluginRoot, sourceRelativePath),
+        'plugin-copy'
+      );
+
+      if (sourceRelativePath === 'commands' || sourceRelativePath.startsWith('commands/')) {
+        const commandSuffix = sourceRelativePath === 'commands'
+          ? ''
+          : sourceRelativePath.slice('commands/'.length);
+        addCopyOperation(
+          operations,
+          seen,
+          module.id,
+          sourceRelativePath,
+          path.join(targetRoot, 'commands', commandSuffix),
+          'codex-command-copy'
+        );
+      }
+
+      if (sourceRelativePath === 'AGENTS.md') {
+        addCopyOperation(
+          operations,
+          seen,
+          module.id,
+          sourceRelativePath,
+          path.join(targetRoot, 'AGENTS.md'),
+          'codex-agent-index-copy'
+        );
+      }
+
+      addRootSkillOperations(operations, seen, module.id, sourceRelativePath, input, targetRoot);
+      addRootAgentOperations(operations, seen, module.id, sourceRelativePath, input, targetRoot);
+    }
+  }
+
+  return operations;
+}
 
 module.exports = createInstallTargetAdapter({
   id: 'codex-home',
@@ -7,4 +192,5 @@ module.exports = createInstallTargetAdapter({
   rootSegments: ['.codex'],
   installStatePathSegments: ['ecc-install-state.json'],
   nativeRootRelativePath: '.codex',
+  planOperations: planCodexOperations,
 });

package/scripts/lib/install-targets/opencode-home.js

@@ -1,10 +1,143 @@
-const { createInstallTargetAdapter } = require('./helpers');
+const fs = require('fs');
+const path = require('path');
+
+const {
+  createInstallTargetAdapter,
+  createManagedOperation,
+  normalizeRelativePath,
+} = require('./helpers');
+
+const PLUGIN_NAME = require('../team-skills-data.json').plugin.name;
+
+function addOperation(operations, seen, operation) {
+  const key = `${operation.sourceRelativePath}=>${operation.destinationPath}`;
+  if (seen.has(key)) {
+    return;
+  }
+  seen.add(key);
+  operations.push(operation);
+}
+
+function addCopyOperation(operations, seen, moduleId, sourceRelativePath, destinationPath, strategy = 'preserve-relative-path') {
+  addOperation(operations, seen, createManagedOperation({
+    moduleId,
+    sourceRelativePath,
+    destinationPath,
+    strategy,
+  }));
+}
+
+function sourceDir(input, sourceRelativePath) {
+  return path.join(input.repoRoot || '', normalizeRelativePath(sourceRelativePath));
+}
+
+function rootAgentFileName(sourcePath, fileName) {
+  const normalizedSourcePath = normalizeRelativePath(sourcePath);
+  if (normalizedSourcePath === 'agents/specialists' || normalizedSourcePath.startsWith('agents/specialists/')) {
+    return `specialist-${fileName}`;
+  }
+  return fileName;
+}
+
+function addRootAgentOperations(operations, seen, moduleId, sourceRelativePath, input, targetRoot) {
+  const normalizedSourcePath = normalizeRelativePath(sourceRelativePath);
+  if (normalizedSourcePath !== 'agents' && !normalizedSourcePath.startsWith('agents/')) {
+    return;
+  }
+
+  const agentDirs = normalizedSourcePath === 'agents'
+    ? ['roles', 'specialists']
+    : [''];
+
+  for (const agentDir of agentDirs) {
+    const sourcePath = agentDir ? path.join(normalizedSourcePath, agentDir) : normalizedSourcePath;
+    const absoluteSourceDir = sourceDir(input, sourcePath);
+    if (!input.repoRoot || !fs.existsSync(absoluteSourceDir)) {
+      continue;
+    }
+
+    const stat = fs.statSync(absoluteSourceDir);
+    if (stat.isFile() && path.extname(absoluteSourceDir) === '.md') {
+      const fileName = rootAgentFileName(path.dirname(sourcePath), path.basename(sourcePath));
+      addCopyOperation(
+        operations,
+        seen,
+        moduleId,
+        sourcePath,
+        path.join(targetRoot, 'agents', fileName),
+        'flatten-agent-copy'
+      );
+      continue;
+    }
+
+    if (!stat.isDirectory()) {
+      continue;
+    }
+
+    for (const entry of fs.readdirSync(absoluteSourceDir, { withFileTypes: true }).sort((left, right) => (
+      left.name.localeCompare(right.name)
+    ))) {
+      if (entry.isFile() && entry.name.endsWith('.md')) {
+        const fileName = rootAgentFileName(sourcePath, entry.name);
+        addCopyOperation(
+          operations,
+          seen,
+          moduleId,
+          path.join(sourcePath, entry.name),
+          path.join(targetRoot, 'agents', fileName),
+          'flatten-agent-copy'
+        );
+      }
+    }
+  }
+}
+
+function planOpenCodeOperations(input, adapter) {
+  const targetRoot = adapter.resolveRoot(input);
+  const pluginRoot = path.join(targetRoot, 'plugins', PLUGIN_NAME);
+  const operations = [];
+  const seen = new Set();
+
+  for (const module of Array.isArray(input.modules) ? input.modules : []) {
+    for (const rawSourcePath of Array.isArray(module.paths) ? module.paths : []) {
+      const sourceRelativePath = normalizeRelativePath(rawSourcePath);
+
+      addCopyOperation(
+        operations,
+        seen,
+        module.id,
+        sourceRelativePath,
+        path.join(pluginRoot, sourceRelativePath),
+        'plugin-copy'
+      );
+
+      if (sourceRelativePath === 'commands' || sourceRelativePath.startsWith('commands/')) {
+        const commandSuffix = sourceRelativePath === 'commands'
+          ? ''
+          : sourceRelativePath.slice('commands/'.length);
+        addCopyOperation(
+          operations,
+          seen,
+          module.id,
+          sourceRelativePath,
+          path.join(targetRoot, 'command', commandSuffix),
+          'opencode-command-copy'
+        );
+      }
+
+      addRootAgentOperations(operations, seen, module.id, sourceRelativePath, input, targetRoot);
+    }
+  }
+
+  return operations;
+}
 
 module.exports = createInstallTargetAdapter({
   id: 'opencode-home',
   target: 'opencode',
   kind: 'home',
-  rootSegments: ['.opencode'],
+  rootSegments: ['.config', 'opencode'],
   installStatePathSegments: ['ecc-install-state.json'],
   nativeRootRelativePath: '.opencode',
+  planOperations: planOpenCodeOperations,
 });

package/scripts/lib/install-targets/registry.js

@@ -9,6 +9,12 @@ const geminiProject = require('./gemini-project');
 const opencodeHome = require('./opencode-home');
 const windsurfProject = require('./windsurf-project');
 
+const PUBLIC_INSTALL_TARGETS = Object.freeze(['claude', 'codex', 'opencode']);
+const TARGET_ALIASES = Object.freeze({
+  'claude-code': 'claude',
+  claudecode: 'claude',
+});
+
 const ADAPTERS = Object.freeze([
   claudeHome,
   cursorProject,
@@ -22,12 +28,25 @@ const ADAPTERS = Object.freeze([
   augmentProject,
 ]);
 
+function normalizeInstallTarget(target) {
+  const normalized = String(target || '').trim().toLowerCase();
+  return TARGET_ALIASES[normalized] || normalized;
+}
+
 function listInstallTargetAdapters() {
   return ADAPTERS.slice();
 }
 
+function listPublicInstallTargetAdapters() {
+  const publicTargets = new Set(PUBLIC_INSTALL_TARGETS);
+  return ADAPTERS.filter(adapter => publicTargets.has(adapter.target));
+}
+
 function getInstallTargetAdapter(targetOrAdapterId) {
-  const adapter = ADAPTERS.find(candidate => candidate.supports(targetOrAdapterId));
+  const normalizedTarget = normalizeInstallTarget(targetOrAdapterId);
+  const adapter = ADAPTERS.find(candidate => (
+    candidate.supports(normalizedTarget) || candidate.supports(targetOrAdapterId)
+  ));
 
   if (!adapter) {
     throw new Error(`Unknown install target adapter: ${targetOrAdapterId}`);
@@ -72,5 +91,8 @@ function planInstallTargetScaffold(options = {}) {
 module.exports = {
   getInstallTargetAdapter,
   listInstallTargetAdapters,
+  listPublicInstallTargetAdapters,
+  normalizeInstallTarget,
+  PUBLIC_INSTALL_TARGETS,
   planInstallTargetScaffold,
 };

package/scripts/lib/release-health.js

@@ -1,24 +1,39 @@
 'use strict';
 
 const { resolveInstallPlan } = require('./install-manifests');
-const { listInstallTargetAdapters } = require('./install-targets/registry');
+const { listPublicInstallTargetAdapters } = require('./install-targets/registry');
 
 const SUPPORT_LEVEL_ORDER = Object.freeze(['recommended', 'strong', 'partial', 'baseline']);
+const TARGET_INTENTIONAL_SKIPS = Object.freeze({
+  codex: new Set(['hooks-runtime', 'evolution', 'rtk-optimization']),
+  opencode: new Set(['rtk-optimization']),
+});
 
 function classifyTargetSupportLevel(plan = {}) {
   const selectedModuleIds = Array.isArray(plan.selectedModuleIds) ? plan.selectedModuleIds : [];
   const requestedModuleIds = Array.isArray(plan.requestedModuleIds) ? plan.requestedModuleIds : [];
+  const skippedModuleIds = Array.isArray(plan.skippedModuleIds) ? plan.skippedModuleIds : [];
   const selected = new Set(selectedModuleIds);
   const selectedCount = selected.size;
   const requestedCount = requestedModuleIds.length;
   const hasCommandsCore = selected.has('commands-core');
   const hasTeamWorkflow = selected.has('team-workflow');
   const hasSharedSkills = selected.has('shared-skills');
+  const intentionalSkips = TARGET_INTENTIONAL_SKIPS[plan.target] || new Set();
+  const onlyIntentionalSkips = skippedModuleIds.every(moduleId => intentionalSkips.has(moduleId));
 
-  if (requestedCount > 0 && selectedCount === requestedCount && hasCommandsCore && hasTeamWorkflow && hasSharedSkills) {
+  if (
+    requestedCount > 0
+    && hasCommandsCore
+    && hasTeamWorkflow
+    && hasSharedSkills
+    && (selectedCount === requestedCount || onlyIntentionalSkips)
+  ) {
     return {
       level: 'recommended',
-      reason: 'Full public workflow chain and primary documentation coverage are available.',
+      reason: onlyIntentionalSkips && selectedCount !== requestedCount
+        ? 'Full public workflow chain is available; skipped modules are target-intentional compatibility gaps.'
+        : 'Full public workflow chain and primary documentation coverage are available.',
     };
   }
 
@@ -46,7 +61,7 @@ function collectTargetSupportMatrix(options = {}) {
   const profileId = options.profileId || 'team';
   const repoRoot = options.repoRoot;
 
-  return listInstallTargetAdapters()
+  return listPublicInstallTargetAdapters()
     .map((adapter) => adapter.target)
     .map((target) => {
       const plan = resolveInstallPlan({ profileId, target, repoRoot });

package/scripts/lib/team-skills-data.json

@@ -66,10 +66,10 @@
         "默认以 `karpathy-guidelines` 的方式先暴露歧义、范围边界与更简单路径，不在入口阶段静默替用户补全高风险假设。",
         "检查现有证据是否齐备：PRD、delivery-plan、arch-design、handoff、execute-log、test-plan、launch-acceptance、deployment-context、release-plan、closeout-summary，以及 `docs/memory/project-context.md`。",
         "若任务边界清晰、影响面小、风险低，优先推荐 `/quick`；否则继续沿 `/team-*` 主链推进。",
-        "若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。",
+        "若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`；默认用 CodeGraph 做 MCP-backed 符号、调用链和影响面证据，需要轻量结构证据时选择 Graphify，需要跨模块或多仓影响面时选择 GitNexus，再把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。",
         "若需求规模较大或涉及多角色并行，实现前先要求把计划切成可独立验收、可独立 handoff 的 story-sized execution units，并确认 `artifact:persist` 已创建对应任务目录与关键 artifact，再进入 `/team-execute`。",
         "若缺少 PRD 或需求边界，推荐 `/team-intake`；若缺少 challenge、design review 或 implementation-readiness，推荐 `/team-plan`；若 readiness proof 与 handoff 齐备，推荐 `/team-execute`；若已完成实现与自测，推荐 `/team-review`；若已获得放行，推荐 `/team-release`；若发布观察窗口结束，推荐 `/team-closeout`。",
-        "若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文；必要时用 Graphify 或 GitNexus 补图谱证据，再进入计划或执行。",
+        "若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文；必要时用 CodeGraph、Graphify 或 GitNexus 补图谱证据，再进入计划或执行。",
         "输出结构化建议：推荐命令、原因、阻塞项、降级路径，并说明是否需要先运行 `npm run workflow:readiness`。"
       ]
     },
@@ -136,7 +136,7 @@
         "默认把 `karpathy-guidelines` 作为计划收口护栏：要求显式写出假设、更简单备选路径、当前不做项，以及为什么本轮范围已经足够。",
         "按任务特征装配动态讨论分组，先讨论再收敛，避免未经质疑直接进入计划冻结。",
         "若启用 `doc-architecture`，补齐 Service Catalog、Communication Matrix、NFR Summary，并明确其 artifact 回落位置。",
-        "若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。",
+        "若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，默认用 CodeGraph 补 MCP-backed 符号、调用链和影响面证据，需要轻量结构证据时选择 Graphify，需要跨模块或多仓影响面时选择 GitNexus，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。",
         "若为企业内部应用，锁定应用等级、技术架构等级、关键组件偏离和资产入口要求，并判断是否必须输出 ADR。",
         "为本次任务显式装配 shared 能力、ECC 增强与可选 enterprise overlay 组合，并说明哪些私有 overlay 能力、runbook 或 overlay 仅按场景启用。",
         "若存在多参数、多角色、多配置或多终端组合，提前判断是否需要 `pairwise-test-design` 压缩测试矩阵。",
@@ -468,7 +468,7 @@
     },
     {
       "name": "update-codemaps",
-      "summary": "扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与 Graphify / GitNexus 图谱分析前置上下文。",
+      "summary": "扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与 CodeGraph / Graphify / GitNexus 图谱分析前置上下文。",
       "primary_role": "doc-updater",
       "inputs": [
         "代码仓结构",
@@ -479,13 +479,13 @@
         "docs/CODEMAPS/ 下的结构化 codemap",
         ".reports/codemap-diff.txt 差异摘要",
         "可供 `/team-help` / `/team-plan` 消费的 brownfield context",
-        "可供 Graphify / GitNexus 继续深挖的结构化问题清单"
+        "可供 CodeGraph / Graphify / GitNexus 继续深挖的结构化问题清单"
       ],
       "steps": [
         "先识别仓库类型、源码目录、入口文件和主要依赖边界。",
         "为 architecture/backend/frontend/data/dependencies 生成 token-lean 文档，不写实现细节噪音。",
         "若已有 codemap，先比较变更比例；超过阈值时要求人工确认再覆盖。",
-        "把结果作为 brownfield context snapshot 的辅助输入；若需要图谱证据，再选择 Graphify 或 GitNexus，并把结论回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。"
+        "把结果作为 brownfield context snapshot 的辅助输入；若需要图谱证据，再选择 CodeGraph、Graphify 或 GitNexus，并把结论回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。"
       ]
     },
     {

package/scripts/release-health-summary.js

@@ -297,7 +297,7 @@ function formatHumanReport(report) {
   }
 
   lines.push('');
-  lines.push('Note: partial/baseline targets are public compatibility paths, not full `/team-*` parity installs.');
+  lines.push('Note: public release health tracks Claude Code, Codex, and OpenCode; other adapters are hidden compatibility paths.');
   return `${lines.join('\n')}\n`;
 }
 

package/scripts/workflow-help.js

@@ -399,7 +399,7 @@ function analyzeTask(options) {
     result.reason = routeReason(catalog, '/team-intake', '未检测到任务 artifact 目录，主链应从 intake 开始。');
     result.missingPrerequisites.push('缺少 docs/artifacts/{YYYY-MM-DD}-{slug}/ 任务目录');
     if (brownfieldRepo) {
-      result.brownfieldSuggestions.push('既有项目建议先执行 /update-codemaps；需要轻量结构证据时用 Graphify，需要跨模块影响面或 MCP 证据时用 GitNexus，再进入 /team-plan 补齐 Brownfield Context Snapshot。');
+      result.brownfieldSuggestions.push('既有项目建议先执行 /update-codemaps；默认用 CodeGraph 做 MCP-backed 符号、调用链和影响面证据，需要轻量结构证据时用 Graphify，需要跨模块或多仓影响面时用 GitNexus，再进入 /team-plan 补齐 Brownfield Context Snapshot。');
     }
     if (!projectContext.exists || projectContext.missingSections.length > 0) {
       addProjectContextRemediation(result, null);
@@ -443,7 +443,7 @@ function analyzeTask(options) {
     result.reason = routeReason(catalog, '/team-plan', '已有 PRD，但尚未形成 Delivery Plan。');
     result.missingPrerequisites.push('缺少 delivery-plan.md');
     if (brownfieldRepo) {
-      result.brownfieldSuggestions.push('如果是 brownfield 任务，在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 Graphify 或 GitNexus 图谱证据。');
+      result.brownfieldSuggestions.push('如果是 brownfield 任务，在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 CodeGraph、Graphify 或 GitNexus 图谱证据。');
     }
     addProjectContextRemediation(result, taskDir);
     return finalizeResult(result, catalog);
@@ -462,7 +462,7 @@ function analyzeTask(options) {
 
   const deliveryPlanText = readText(deliveryPlanPath).toLowerCase();
   if (brownfieldRepo && !deliveryPlanText.includes('brownfield context snapshot')) {
-    result.brownfieldSuggestions.push('建议在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 Graphify 或 GitNexus 图谱证据。');
+    result.brownfieldSuggestions.push('建议在 delivery-plan.md 中补齐 Brownfield Context Snapshot；必要时引用 CodeGraph、Graphify 或 GitNexus 图谱证据。');
   }
 
   if (!hasHandoffEvidence && !exists(executeLogPath)) {

package/skills/codegraph/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: codegraph
+description: >
+  将 CodeGraph 作为默认内置 MCP-backed 代码图谱能力接入，用于 brownfield 符号搜索、
+  调用链、影响面和上下文查询。输出必须回落到 `/team-*` 主链和 artifacts。
+origin: colbymchenry/codegraph (default dependency with upstream installer wrapper)
+---
+
+# CodeGraph
+
+## 用途
+
+- 对已初始化的目标项目做本地代码图谱查询：符号搜索、callers/callees、impact、focused context。
+- 在设计、执行和评审前补结构证据，减少依赖纯文本搜索造成的遗漏。
+- 为 `/team-plan`、`/team-execute`、`/team-review` 提供可追溯的 MCP-backed 影响面证据。
+
+## 触发信号
+
+- brownfield 项目需要快速回答“这个 symbol 在哪里”“谁调用它”“改它会影响谁”。
+- 目标 agent 已通过 TSP 安装流程配置 CodeGraph MCP，且目标项目存在 `.codegraph/`。
+- Graphify 的轻量结构证据不足，或者需要比 GitNexus 更贴近当前 agent MCP 工具面的本地查询。
+
+## 默认工作流
+
+1. 先跑 `npm run codegraph:doctor`，确认 Node、CodeGraph 包和当前 target wrapper 可用。
+2. 在消费方目标项目根目录手动初始化索引：
+   ```bash
+   codegraph init -i
+   ```
+3. 通过 MCP 或 CLI 使用 `search/context/callers/callees/impact/node/files/status` 查询。
+4. 把关键发现回落到主链：
+   - 规划阶段 -> `/team-plan` 的 Brownfield Context Snapshot 和 readiness 证据
+   - 执行阶段 -> `/team-execute` 的 story slice 影响面说明
+   - 评审阶段 -> `/team-review` 的风险、回归边界和放行建议
+
+## 输出约定
+
+- CodeGraph 数据库由上游工具管理，通常写入目标项目 `.codegraph/`。
+- TSP 侧只沉淀结论，不沉淀上游数据库：
+  - 分析目标
+  - 查询入口（MCP tool 或 CLI 命令）
+  - 核心发现
+  - 对 `/team-*` 决策的影响
+  - 后续验证或回退建议
+
+## 边界与禁用项
+
+- TSP 安装时只运行 `scripts/install-codegraph.js` wrapper，不使用上游 `--target=auto`。
+- TSP 安装流程不运行 `codegraph init -i`，避免在平台仓库或消费方仓库隐式写入 `.codegraph/`。
+- 不提交 `.codegraph/` 数据库或将其作为 TSP artifact。
+- CodeGraph 结论不能绕过 `/team-plan`、`/team-review` 或验证门禁。
+
+## 推荐组合
+
+- 默认 brownfield 结构证据：`/team-help -> /update-codemaps -> npm run codegraph:doctor -> codegraph init -i -> /team-plan`
+- 快速影响面确认：`/team-execute -> CodeGraph impact/callers/callees -> /handoff -> /team-review`
+- 深度多仓或许可证受限场景：按需选择 GitNexus 或 Graphify，并把结论统一回落到主链。

package/skills/codegraph/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "CodeGraph Code Intelligence"
+  short_description: "用 CodeGraph 补齐 MCP-backed 符号、调用链与影响面证据"
+  default_prompt: "Use $codegraph when brownfield work needs local MCP-backed symbol search, callers/callees, impact, or focused context. Keep CodeGraph findings tied to /team-plan, /team-execute, or /team-review, and do not treat .codegraph databases as TSP artifacts."