cgraphx 1.4.3 → 2.0.0

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "cgraphx",
-  "version": "1.4.3",
-  "description": "Supercharge AI coding agents with semantic code intelligence — surgical context, fewer tool calls, faster answers. 100% local.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "2.0.0",
+  "description": "Local markdown knowledge base, read-only database query, and developer timeline toolkit for Claude Code.",
   "bin": {
-    "cgraphx": "./dist/bin/codegraph.js"
+    "cgraphx": "./dist/cli/index.js"
   },
   "files": [
     "dist",
@@ -13,25 +11,18 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc && npm run copy-assets && node -e \"require('fs').chmodSync('dist/bin/codegraph.js', 0o755)\"",
-    "preuninstall": "node dist/bin/uninstall.js",
-    "copy-assets": "node -e \"const fs=require('fs');const path=require('path');fs.mkdirSync('dist/db',{recursive:true});fs.copyFileSync('src/db/schema.sql','dist/db/schema.sql');fs.mkdirSync('dist/markdown',{recursive:true});fs.copyFileSync('src/markdown/schema.sql','dist/markdown/schema.sql');fs.mkdirSync('dist/timeline',{recursive:true});fs.copyFileSync('src/timeline/schema.sql','dist/timeline/schema.sql');fs.mkdirSync('dist/extraction/wasm',{recursive:true});fs.readdirSync('src/extraction/wasm').filter(f=>f.endsWith('.wasm')).forEach(f=>fs.copyFileSync('src/extraction/wasm/'+f,'dist/extraction/wasm/'+f));const tmplSrc='assets/claude-template';const tmplDest='dist/.claude-template';if(fs.existsSync(tmplSrc)){fs.rmSync(tmplDest,{recursive:true,force:true});fs.mkdirSync(tmplDest,{recursive:true});(function walk(from,to){for(const e of fs.readdirSync(from,{withFileTypes:true})){if(e.name==='node_modules'||e.name==='.DS_Store'||e.name.startsWith('.'))continue;const fp=path.join(from,e.name);const tp=path.join(to,e.name);if(e.isDirectory()){fs.mkdirSync(tp,{recursive:true});walk(fp,tp)}else if(e.isFile()){fs.copyFileSync(fp,tp)}}})(tmplSrc,tmplDest)}\"",
+    "build": "tsc && node scripts/copy-assets.cjs && node -e \"require('fs').chmodSync('dist/cli/index.js',0o755)\"",
     "dev": "tsc --watch",
-    "cli": "npm run build && node dist/bin/codegraph.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:eval": "vitest run __tests__/evaluation/",
-    "eval": "npm run build && npx tsx __tests__/evaluation/runner.ts",
-    "clean": "node -e \"const fs=require('fs');fs.rmSync('dist',{recursive:true,force:true})\"",
-    "prepublishOnly": "npm run build"
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepublishOnly": "npm run build",
+    "preuninstall": "node dist/cli/uninstall.js"
   },
-  "keywords": [
-    "code-intelligence",
-    "knowledge-graph",
-    "static-analysis"
-  ],
-  "author": "",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.5.0 <27.0.0"
+  },
   "dependencies": {
     "@clack/prompts": "^1.3.0",
     "commander": "^14.0.2",
@@ -39,22 +30,18 @@
     "fast-wrap-ansi": "^0.2.0",
     "ignore": "^7.0.5",
     "jsonc-parser": "^3.3.1",
+    "markdown-it": "^14.3.0",
     "mysql2": "^3.11.0",
     "pg": "^8.12.0",
     "picomatch": "^4.0.3",
-    "sisteransi": "^1.0.5",
-    "tree-sitter-wasms": "^0.1.11",
-    "web-tree-sitter": "^0.25.3"
+    "sisteransi": "^1.0.5"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^20.19.30",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^22.5.0",
     "@types/pg": "^8.20.0",
     "@types/picomatch": "^4.0.2",
     "typescript": "^5.0.0",
     "vitest": "^2.1.9"
-  },
-  "engines": {
-    "node": ">=20.0.0 <25.0.0"
   }
 }

package/scripts/copy-assets.cjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * copy-assets.cjs — postbuild asset copier for cgraphx 2.0.
+ *
+ * `tsc` only emits compiled JS/d.ts; runtime assets that live alongside the
+ * TS sources (SQL schemas, the Claude skill template, the web static assets)
+ * must be copied into `dist/` separately. This script is the single source of
+ * truth for that.
+ *
+ * What it copies (intentionally narrow — cgraphx 2.0 dropped the code graph,
+ * so there is no graph schema and no tree-sitter wasm to ship):
+ *
+ *   src/core/markdown/schema.sql  → dist/core/markdown/schema.sql
+ *   src/core/timeline/schema.sql  → dist/core/timeline/schema.sql
+ *   assets/claude-template/**     → dist/.claude-template/**
+ *   src/web/public/**             → dist/web/public/**
+ *
+ * What it does NOT copy:
+ *   - src/core/db/schema.sql  (does not exist in 2.0 — db layer has no static schema)
+ *   - src/extraction/wasm/**  (graph extraction was removed)
+ *
+ * Run from the repo root via `npm run build` (after `tsc`).
+ */
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const root = path.resolve(__dirname, '..');
+const dist = path.join(root, 'dist');
+
+function copyFile(from, to) {
+  fs.mkdirSync(path.dirname(to), { recursive: true });
+  fs.copyFileSync(from, to);
+}
+
+// 递归拷贝时跳过的常见噪音,避免脏源树泄漏进发布包。
+const SKIP_NAMES = new Set(['node_modules', '.DS_Store']);
+
+// 递归拷贝整棵目录树(沿用 walk 模式;dist 镜像 src 布局)。
+function walk(from, to) {
+  for (const entry of fs.readdirSync(from, { withFileTypes: true })) {
+    if (SKIP_NAMES.has(entry.name)) continue;
+    const fp = path.join(from, entry.name);
+    const tp = path.join(to, entry.name);
+    if (entry.isDirectory()) {
+      fs.mkdirSync(tp, { recursive: true });
+      walk(fp, tp);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(fp, tp);
+    }
+  }
+}
+
+// 1) SQL schemas — markdown + timeline subsystems. The dist/ path mirrors the
+//    src/ layout including the `core/` nesting, because runtime resolvers look
+//    them up relative to the compiled module file (schema-bootstrap.ts).
+copyFile(
+  path.join(root, 'src/core/markdown/schema.sql'),
+  path.join(dist, 'core/markdown/schema.sql')
+);
+copyFile(
+  path.join(root, 'src/core/timeline/schema.sql'),
+  path.join(dist, 'core/timeline/schema.sql')
+);
+
+// 2) Claude skill/agent/hooks template — walked recursively.
+const tmplSrc = path.join(root, 'assets/claude-template');
+const tmplDest = path.join(dist, '.claude-template');
+
+if (fs.existsSync(tmplSrc)) {
+  fs.rmSync(tmplDest, { recursive: true, force: true });
+  fs.mkdirSync(tmplDest, { recursive: true });
+  walk(tmplSrc, tmplDest);
+}
+
+// 3) web static assets (app.css etc.) — walked recursively, mirrored to
+//    dist/web/public so the compiled server.ts resolves them relative to its
+//    own module file. Absent source dir → silent skip (same mode as template).
+const webPublicSrc = path.join(root, 'src/web/public');
+const webPublicDest = path.join(dist, 'web/public');
+
+if (fs.existsSync(webPublicSrc)) {
+  fs.rmSync(webPublicDest, { recursive: true, force: true });
+  fs.mkdirSync(webPublicDest, { recursive: true });
+  walk(webPublicSrc, webPublicDest);
+}
+
+console.log('copy-assets: schemas + .claude-template + web/public copied into dist/');

package/dist/.claude-template/commands/my-commit.md

@@ -1,9 +0,0 @@
-这是聚合项目 根目录为 hx
-hx没有git管理
-子项目都有git管理
-另外提交代码 message标题格式要求为: 
-- CRM-req74181高权紧急开机周期限制及欠费额度展示优化-client@req74181
-- bug54911审批单号码校验规则优化@bug54911
-message 内容可以允许记录更多的关键细节
-
-如果不知道需求或者bug编号 提出问题询问

package/dist/.claude-template/skills/cgraphx/SKILL.md

@@ -1,143 +0,0 @@
----
-name: cgraphx
-description: 代码图谱工具集 — 通过 codegraph_explore MCP 或 cgraphx CLI 查代码结构、调用关系、影响半径。Use when 代码结构/调用关系/谁调用/被谁调用/影响范围/调用链/代码搜索/找函数/找类/symbol/function/method/class/impact/affected/重构风险/代码智能/cgraphx。任何代码理解或修改前的"先看一下"场景都该用本 skill 而不是直接 grep。
----
-
-## 何时用 cgraphx(优先于 grep / Read)
-
-任何"理解代码"或"改代码前先看一眼"的场景:
-- 这个函数被谁调用?改它会崩哪里?
-- X 是怎么调用到 Y 的?(流程/调用链)
-- 找 UserService 类 / login 方法在哪个文件
-- 改这些文件会影响哪些测试?
-- 这个接口的所有实现
-
-<HARD-GATE>
-cgraphx 不是百分百可靠, 有些代码关系不一定能扫描, 依然需要结合 grep协同探索
-</HARD-GATE>
-**优先级**:cgraphx > grep > Read。cgraphx 是 tree-sitter AST 派生的真实符号图,能找到 grep 必漏的(同名方法、interface 实现、跨语言调用、被注解但模式不规则的入口)。grep 只在 cgraphx 索引未覆盖(configs、docs、generated code)时用。
-
-## 工具(由 cgraphx 提供)
-
-### MCP 工具(首选,agent 自动调)
-
-| 工具 | 用途 |
-|---|---|
-| `codegraph_explore` | **首选**。给一组符号名或自然语言问题,返回相关符号的源码 + 它们之间的调用路径(含动态派生边如 callback / React render / JSX children)+ 影响半径。一次调用通常够答完整问题。 |
-
-MCP 不可用(未配置 / 启动失败 / 在 Claude Code 外)走下面 CLI。
-
-### CLI(走 Bash 调,作为 MCP 的 fallback)
-
-```bash
-cgraphx <subcommand> [args]
-```
-
-| 操作 | 命令 | 何时用 |
-|---|---|---|
-| 搜符号 | `cgraphx query "<name>"` | 按名字找 function/method/class/interface |
-| 看符号定义 | `codegraph_explore` MCP,或 Bash `cgraphx query <name>` 后看返回 | 拿到完整源码 |
-| 谁调用 X | `cgraphx callers <symbol>` | inbound 调用方 |
-| X 调用谁 | `cgraphx callees <symbol>` | outbound 被调用方 |
-| 改 X 的影响面 | `codegraph_impact(symbol, depth)` MCP | impact radius(BFS 影响传播,基于索引) |
-| 改文件的受影响测试 | `cgraphx affected [<files>...]` | 找受影响测试文件 |
-| 构建 task 上下文 | `codegraph_explore` MCP | 给 AI 一段任务描述,返回相关代码片段 + 调用路径 |
-| 看索引状态 | `cgraphx status` | files/nodes/edges 计数、last_indexed_at |
-| 增量同步 | `cgraphx sync` | 文件改了之后 |
-| 全量重建 | `cgraphx index` | 出问题或大改动时 |
-| 看文件结构 | `cgraphx files [options]` | 项目文件概览 |
-
-## 决策树(给 agent 用)
-
-```
-用户问的 / 任务需要的:
-├── "X 是怎么工作的" / "找 X" / "X 在哪" / 流程类问题
-│   → codegraph_explore MCP(一次拿源码 + 调用路径)
-│
-├── "改 X 会影响哪里" / "X 的 blast radius" / 重构前评估
-│   → codegraph_impact(symbol) MCP(看影响半径)
-│   → 或 cgraphx affected <file>(看受影响测试)
-│
-├── "谁调用 X" / "X 的 caller" / 反向追踪
-│   → cgraphx callers <symbol>
-│
-├── "X 调用什么" / "X 的 callee" / 正向追踪
-│   → cgraphx callees <symbol>
-│
-├── 找配置文件、文档、generated code(cgraphx 不索引的)
-│   → grep / Read(cgraphx 在这里无能为力)
-│
-└── 索引可能 stale(改动后未 sync)
-    → cgraphx sync,或 cgraphx status 看新鲜度
-```
-
-## 何时派子 agent(让上下文更干净)
-
-主 agent **直接调 cgraphx 工具时,大段原文(源码、callers/callees 链、impact 半径)会进自己的上下文**,挤占决策与待办的空间。本 skill 工具适合精确查询,但**模糊意图的重探索型任务**适合派子 agent 在隔离上下文里跑。
-
-### 判断规则(R4:目标精度)
-
-主 agent **已知精确目标**(具体符号名 / 文件名)→ **不派**,直接调上面工具;主 agent **只有模糊意图**(系统理解 / 梳理 / 调研型)→ **派**。
-
-具体例子:
-
-| 场景 | 不派(直接调工具) | 派(派子 agent) |
-|---|---|---|
-| 找符号位置 | "login 函数被谁调" → `cgraphx callers login` | "梳理 timeline 子系统的全貌" |
-| 改动影响 | "改 work_order.ts 影响哪些测试" → `cgraphx affected work_order.ts` | "系统理解 hook 触发到事件落库的完整流程" |
-| 调用链 | "X 调用什么" → `cgraphx callees X` | "调研 cgraphx 的 MCP 工具是怎么从 initialize 一路走到 explore 的" |
-
-### 派的方法(决定派时执行)
-
-1. **Read** 本 skill 目录下的 `./agent-prompt.md`
-2. **Agent tool 调用**:
-   ```
-   Agent({
-     subagent_type: "general-purpose",
-     prompt: <agent-prompt.md 文件内容> + "\n\n当前任务: " + <用户原话或你的转述>
-   })
-   ```
-3. **直接采纳**子 agent 返回的提炼结论 —— 不要再自己调 codegraph_explore / callers / callees 重新查(那是浪费)
-4. 结论不够 → 再派一次(换 prompt 重点,如"重点看 X 的副作用")或回头自己调工具补
-
-### 代价
-
-- **不派的代价**:大段源码 / 调用链进主上下文,后续决策可用 budget 变小
-- **派的代价**:子 agent 本身耗 token,简单查询派反而更贵
-- **R4 是平衡点**:只在"模糊意图 + 主 agent 无法精确判断目标"时派
-
-## 何时不用 cgraphx
-
-- **产品需求 / UX / 业务逻辑**:cgraphx 是代码智能,不管业务(用 `code-impact-api` skill 查 docs/knowledge/)
-- **数据库数据**:`cgraphx db` 子系统(见 db-query skill)
-- **开发历史 / 最近做了什么**:`cgraphx timeline` 子系统(见 developer-timeline skill)
-- **配置文件 / 文档 / 日志**:grep 更直接
-
-## 前置条件
-
-- 项目必须先跑过 `cgraphx init`(建索引)
-- MCP 配置:`cgraphx install` 已写到 `.claude/settings.json`(项目级,默认 local)
-- 索引新鲜度:文件改动后会有 ~1s 同步延迟;长时间未 sync 时跑 `cgraphx sync`
-
-## 性能特征
-
-- 单次 explore 调用:小仓库 1 次、中型 2-3 次、大型(vscode 量级)3-5 次
-- 响应延迟:sub-second(SQLite + WAL + FTS5)
-- 工具调用次数目标:flow 问题 1-3 次 cgraphx 调用 + 0 Read/Grep(理想状态)
-
-## 失败处理
-
-- **`cgraphx status` 报未初始化** → 提示用户跑 `cgraphx init`,不要 silent 跑(索引是用户决定)
-- **MCP 未连上** → CLI fallback;两者都不可用 → 退化 grep(精度损失)
-- **结果为空** → 可能符号名拼错 / 不在索引里;试 `cgraphx query` 模糊搜
-
-## 探索结果收口(给 clarify/spec/plan)
-
-只有当本 skill 用于需求澄清、spec 或 plan 前置探索时,才做简短收口。简单精确查询(如"函数在哪")可以直接回答,不套模板。
-
-按需使用以下 4 项,无内容可省略:
-
-- **查到的关键事实**:入口、调用方、被调用方、数据流、测试、配置或影响范围。
-- **对决策的影响**:哪些选择应被锁定、排除或上报用户确认。
-- **应进入 PRD/spec/plan 的内容**:接口行为、兼容性、权限、异常、受影响文件、任务依赖、验证命令等。
-- **仍不确定/需确认**:需要继续查代码、查数据库、问用户或留到后续阶段的点。

package/dist/.claude-template/skills/cgraphx/agent-prompt.md

@@ -1,56 +0,0 @@
-# cgraphx 探索子 agent prompt
-
-> 主 agent 通过 Agent tool 调用本文件时,把这份完整内容作为 prompt 传给 `general-purpose` 子 agent,后接 `\n\n当前任务: <用户原话>`。
-
-## 你的角色
-
-你是 cgraphx 探索子 agent。你在**隔离上下文**里跑,主 agent **看不到你的中间过程**(工具调用、源码引用、调用链原文),**只拿到你的最终返回**。
-
-主 agent 派你来是因为它收到一个**模糊意图的重探索型任务**(如"梳理 X / 系统理解 Y / 调研 Z"),需要多步探索才能给结论。你的产出会被主 agent **直接采纳**,不需要它再回头查。
-
-## 可用工具
-
-| 工具 | 用途 |
-|---|---|
-| `codegraph_explore` MCP(首选) | 给一组符号名或自然语言问题,返回相关符号源码 + 调用路径(含 callback / React render / JSX children 等动态派生边) |
-| `codegraph_impact(symbol, depth)` MCP | 改动影响半径(基于索引,返回 Subgraph 含 nodes/edges) |
-| `cgraphx query "<name>"` CLI | 按名字模糊搜符号 |
-| `cgraphx callers <symbol>` CLI | 反向追踪(谁调 X) |
-| `cgraphx callees <symbol>` CLI | 正向追踪(X 调谁) |
-| `cgraphx affected [<files>...]` CLI | 受影响测试文件 |
-| `cgraphx status` CLI | 看索引新鲜度 |
-| `cgraphx files` CLI | 项目文件概览 |
-| `Read` / `Grep` | cgraphx 不覆盖时(configs、docs、generated code) |
-
-**优先级**:cgraphx > grep > Read。
-
-## 探索策略
-
-1. **先用 `codegraph_explore` 一次性拿主体符号 + 调用路径** —— 给它一组符号名(qualified name 优先,如 `Class.method`)或自然语言问题
-2. 看返回的 **Flow 段**(调用路径)和源码片段,判断覆盖范围够不够
-3. 不够 → 补 1-2 次 `codegraph_explore`(换符号名组合)或 `cgraphx callers/callees`(定向追踪某个具体符号)
-4. **不要 Read 大段文件** —— explore 已经返回了相关源码片段,Read 整文件是浪费
-5. **不要无限发散** —— 探索深度以"能回答主 agent 的任务"为准,不要顺手把整个代码库梳一遍
-6. 还不够(符号不存在 / 调用链断裂 / 跨语言调用 cgraphx 不覆盖 / 动态派生边没合成)→ **在返回结论里明确告诉主 agent**:"X 到 Y 的链路在 cgraphx 里找不到,建议问用户 A / 查文档 B / 用 grep 兜底 C",**不要反复试错 explore**
-
-## 输出格式
-
-至少包含:
-
-- **主体符号清单**:每个符号给 `名字 + 文件路径:行号 + 一句话职责`
-- **调用关系**:谁调谁,关键路径(用箭头表示,如 `A → B → C`)
-- **关键发现 / 注意事项**:副作用的、隐藏依赖、需要主 agent 决策时注意的点(如"X 在 Y 之前必须先初始化")
-- **待主 agent 决策的不确定项**:明确列出来,不要藏在结论里(如"X 和 Y 的关联在 cgraphx 里没边,建议问用户 A / 查文档 B 核实")
-
-不要输出:
-
-- 大段源码引用(explore 已经看过,主 agent 需要时它会自己 Read)
-- 中间探索步骤 / 工具调用日志
-- "我尝试了 X 但失败"这种过程噪声 —— 失败的直接说"X 不可达/不存在"
-- 你不确定的内容(用"【不确定】X,建议主 agent 验证"标记,不要瞎编)
-
-## 约束
-
-- **不要修改任何文件** —— 你是只读探索,Edit/Write 工具不要调
-- **不要假设主 agent 知道你的中间步骤** —— 你的 final message 就是它看到的全部,所以结论必须自洽
-- **不要建议主 agent 派第二次子 agent** —— 如果一次没答完整,在你能力范围内的就再探索几次;超出能力直接说"本任务需要主 agent 自己 X"

package/dist/.claude-template/skills/code-impact-api/SKILL.md

@@ -1,143 +0,0 @@
----
-name: code-impact-api
-description: 项目文档知识库查询入口 — 通过 cgraphx docs CLI 查询 docs/knowledge/ 下的业务决策、概念定义、历史教训。Use when 任务开始时 / 查业务概念 / 查历史决策 / 对齐术语 / 找相关文档 / 探索既有知识。
----
-
-## 这个 skill 解决什么问题
-
-新任务开始时,**先查现有知识库**,在既有决策和概念基础上推进工作,而不是从零推断业务背景。
-
-典型场景:
-- "实现订单退订功能" → 先看是否已有退订决策文档,有则直接采纳
-- "对齐业务概念命名" → 看 concept 列表,用团队已有命名,避免造新词
-- "找相关文档" → 按 concept/domain/tag 过滤,定位最相关决策
-
-## 工具(由 cgraphx 提供,通过 CLI 调用)
-
-```bash
-cgraphx docs <subcommand> [options] [project-path]
-```
-
-| 操作 | 命令 |
-|---|---|
-| 全量扫描入库 | `cgraphx docs index [project-path]` |
-| 列出所有 concept | `cgraphx docs concepts [project-path]` |
-| 列出所有 domain | `cgraphx docs domains [project-path]` |
-| 列出所有 tag | `cgraphx docs tags [project-path]` |
-| 多维过滤查询 | `cgraphx docs find [project-path] --concept=X --domain=Y --tag=Z --status=active --type=decision --q=关键词 --limit=20` |
-| 文档引用关系 | `cgraphx docs refs <doc-id-or-path> [project-path]` |
-| 文档详情(摘要+元数据) | `cgraphx docs show <doc-id-or-path> [project-path]` |
-
-所有命令支持 `--json` 切换为机器可读格式。
-
-## 工作流(任务开始时)
-
-```
-1. cgraphx docs concepts
-   → 列出所有业务 concept(跨文档去重 + 关联文档数 + 所属 domain)
-   → 用语义匹配判断任务涉及的 concept 是否已存在
-
-2. 命中 concept 后:
-   cgraphx docs find --concept=<name>
-   → 返回该 concept 关联的所有文档,含:
-     - title / type / status / updated
-     - summary(Summary 章节内容,作为"是否需要读全文"的依据)
-     - path(项目根相对,用 Read 工具看全文)
-
-3. summary 够用 → 直接采纳,开始开发
-   summary 不够 → Read 返回的 path 原文,再判断
-```
-
-## 何时派子 agent(让上下文更干净)
-
-主 agent **直接调 cgraphx docs 工具时,大段原文(文档 Summary、find 返回的文档列表、docs/show 输出)会进自己的上下文**,挤占决策与待办的空间。本 skill 工具适合精确查询,但**模糊意图的重探索型任务**适合派子 agent 在隔离上下文里跑。
-
-### 判断规则(R4:目标精度)
-
-主 agent **已知精确目标**(具体 concept / 文档 id / 关键词)→ **不派**,直接调上面工具;主 agent **只有模糊意图**(系统理解 / 梳理 / 调研型)→ **派**。
-
-具体例子:
-
-| 场景 | 不派(直接调工具) | 派(派子 agent) |
-|---|---|---|
-| 找具体决策 | "订单退订的决策文档有没有" → `cgraphx docs find --q=退订` | "调研订单业务的全部决策" |
-| 看 concept | "X concept 在哪些文档里" → `cgraphx docs find --concept=X` | "梳理 X 业务的所有 concept 和它们的关系" |
-| 单文档详情 | "show 一下 decision-001.md" → `cgraphx docs show decision-001.md` | "系统理解这块业务为什么这么做,把所有相关决策串起来" |
-
-### 派的方法(决定派时执行)
-
-1. **Read** 本 skill 目录下的 `./agent-prompt.md`
-2. **Agent tool 调用**:
-   ```
-   Agent({
-     subagent_type: "general-purpose",
-     prompt: <agent-prompt.md 文件内容> + "\n\n当前任务: " + <用户原话或你的转述>
-   })
-   ```
-3. **直接采纳**子 agent 返回的提炼结论 —— 不要再自己调 `cgraphx docs find/show` 重新查(那是浪费)
-4. 结论不够 → 再派一次(换 prompt 重点,如"重点看 decision 之间的关系")或回头自己调工具补
-
-### 代价
-
-- **不派的代价**:大段 Summary / find 列表进主上下文,后续决策可用 budget 变小
-- **派的代价**:子 agent 本身耗 token,简单查询派反而更贵
-- **R4 是平衡点**:只在"模糊意图 + 主 agent 无法精确判断目标"时派
-
-## 工作流(查文档间引用)
-
-```
-cgraphx docs refs docs/knowledge/decision-001.md
-→ 输出双向引用:
-  Outgoing: 这份文档引用了哪些
-  Incoming: 哪些文档引用了这份
-```
-
-适合"这个决策被谁引用了"、"还有哪些相关文档"。
-
-## 索引管理
-
-文档变更后**必须重新触发扫描**(覆盖式重建,不走增量):
-
-```bash
-cgraphx docs index              # 全量扫 docs/knowledge/,事务性覆盖
-```
-
-什么时候跑:
-- 写了新 .md 到 docs/knowledge/
-- 修改了已有 .md 的 frontmatter 或 Summary
-- 删除了 .md
-- 重新 clone 仓库后
-
-不需要跑:
-- 改了 .md 的非 Summary 章节(那些不进索引,改完直接 Read 就行)
-
-## 文档规范要点(写新文档时遵守,详见 code-impact-markdown skill)
-
-frontmatter **7 必填**(缺一即被跳过):`title` / `document_type` / `domains` / `concepts` / `status` / `source_type` / `updated`
-
-**章节**:**只有 `## Summary`(或 `## 摘要`)进索引**,其他章节留文件里,AI 想看就 Read。
-
-详细 frontmatter 枚举值、稳定标题、命名规则、模板 → 见 `code-impact-markdown` skill。
-
-## 关键词搜索(中文友好)
-
-`cgraphx docs find --q=关键词` 走 **LIKE 子串匹配**(不用 FTS5,因为 SQLite 默认 tokenizer 对中文不友好)。任何中文/英文 substring 都能命中 title 或 Summary。
-
-## 排除范围(明确不做)
-
-- ❌ 不扫 `docs/knowledge/` 之外(README、CHANGELOG、第三方文档一律忽略)
-- ❌ 不存文档全文(只存 title + Summary + 元数据 + 关系;其他章节 AI 自己 Read)
-- ❌ 不修改文档(变更只能由人/AI 写文件后重新 `docs index`)
-- ❌ 不与代码索引打通(文档不会自动建立到代码符号的反向链接)
-- ❌ 不预计算 concept↔concept 关联(AI 从 find 返回的 concepts 列表自己推断)
-
-## 探索结果收口(给 clarify/spec/plan)
-
-只有当本 skill 用于需求澄清、spec 或 plan 前置探索时,才做简短收口。简单精确查询(如"有没有某个决策文档")可以直接回答,不套模板。
-
-按需使用以下 4 项,无内容可省略:
-
-- **查到的关键事实**:历史决策、状态、适用范围、关键规则、引用路径、团队已有术语。
-- **对决策的影响**:哪些规则应继承、排除、更新,哪些需要领导/业务方重新拍板。
-- **应进入 PRD/spec/plan 的内容**:已确认业务规则、非目标、兼容性要求、不可改动旧行为、必须复用机制等。
-- **仍不确定/需确认**:历史文档过期、状态非 active、概念冲突或需要用户确认的部分。

package/dist/.claude-template/skills/code-impact-api/agent-prompt.md

@@ -1,51 +0,0 @@
-# code-impact-api 探索子 agent prompt(docs/knowledge/ 业务知识探索)
-
-> 主 agent 通过 Agent tool 调用本文件时,把这份完整内容作为 prompt 传给 `general-purpose` 子 agent,后接 `\n\n当前任务: <用户原话>`。
-
-## 你的角色
-
-你是 docs/knowledge/ 业务知识探索子 agent。你在**隔离上下文**里跑,主 agent **看不到你的中间过程**(工具调用、文档 Summary 原文),**只拿到你的最终返回**。
-
-主 agent 派你来是因为它收到一个**模糊意图的重探索型任务**(如"调研订单业务的所有决策 / 梳理 X 业务的所有 concept / 系统理解这块业务为什么这么做"),需要遍历多篇文档才能给结论。你的产出会被主 agent **直接采纳**,不需要它再回头查。
-
-## 可用工具
-
-| 工具 | 用途 |
-|---|---|
-| `cgraphx docs concepts` | 列出所有业务 concept(跨文档去重 + 关联文档数 + 所属 domain) |
-| `cgraphx docs domains` | 列出所有 domain |
-| `cgraphx docs tags` | 列出所有 tag |
-| `cgraphx docs find --concept=X --domain=Y --tag=Z --q=关键词 --limit=20` | 多维过滤查询,返回 title / type / status / summary / path |
-| `cgraphx docs show <doc-id-or-path>` | 单文档详情(摘要 + 元数据) |
-| `cgraphx docs refs <doc-id-or-path>` | 文档双向引用(Outgoing + Incoming) |
-| `Read` | 读 docs/knowledge/*.md 全文(summary 不够时) |
-
-## 探索策略
-
-1. **先 `cgraphx docs concepts`** 看全局 concept 清单,语义匹配任务涉及的 concept
-2. 命中 concept → `cgraphx docs find --concept=X` 拿关联文档清单(含 Summary)
-3. **不要立即 Read 全文** —— 先看 find 返回的 Summary,够用就直接用
-4. Summary 不够 → `cgraphx docs show <id>` 或 `Read` 全文(只读你确定需要的)
-5. 跨文档关系 → `cgraphx docs refs <id>` 看引用图
-6. **不要遍历所有文档** —— 任务范围内够用就停
-
-## 输出格式
-
-至少包含:
-
-- **命中的 concept / domain 清单**:每个给 `名字 + 一句话定义(从关联文档 Summary 提炼)`
-- **相关决策文档清单**:每篇给 `title + 一句话核心结论 + path(主 agent 需要时自己读)`
-- **关键发现 / 团队既有约定**:主 agent 决策时需要遵守的(如"团队已决定用 X 方案,不要再造新轮子")
-
-不要输出:
-
-- 大段 Summary 原文 / 文档全文引用
-- 中间探索步骤 / 工具调用日志
-- "我尝试了 X 但失败"这种过程噪声 —— 失败的直接说"X 不存在 / 未找到"
-- 你不确定的内容(用"【不确定】X,建议主 agent 验证"标记)
-
-## 约束
-
-- **不要修改任何文件** —— 你是只读探索,Edit/Write 工具不要调;特别**不要修改 docs/knowledge/ 下任何 .md**(变更由人/主 agent 决定后再走 code-impact-markdown skill)
-- **不要假设主 agent 知道你的中间步骤** —— 你的 final message 就是它看到的全部
-- **不要建议主 agent 派第二次子 agent** —— 一次没答完整就再探索几次,超出能力直接说