@ppdocs/mcp 3.2.37 → 3.3.0

package/dist/tools/index.js

@@ -1,11 +1,11 @@
 /**
  * MCP 工具注册入口
- * 12 个工具, 6 个子模块
+ * 13 个工具, 7 个子模块
  *
  * 🔗 初始化:   kg_init                                           (1个)
  * 📊 导航:     kg_status                                         (1个)
- * 📚 知识:     kg_projects, kg_rules                              (2个)
- * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区)     (3个)
+ * 📚 知识:     kg_projects, kg_workflow                           (2个)
+ * 📝 工作流:   kg_task(任务记录), kg_files, kg_discuss(讨论区), kg_ref (4个)
  * 🔀 关系核心: kg_flowchart(逻辑流程图 — 关系型知识锚点)           (1个)
  * 🔬 代码分析: code_scan, code_smart_context, code_full_path      (3个)
  * 🏛️ 协作:    kg_meeting                                         (1个)
@@ -14,10 +14,11 @@ import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';
 import { registerStatusTool } from './kg_status.js';
 import { registerProjectTools } from './projects.js';
-import { registerRuleTools } from './rules.js';
+import { registerWorkflowTools } from './workflow.js';
 import { registerTaskTools } from './tasks.js';
 import { registerFileTools } from './files.js';
 import { registerDiscussionTools } from './discussion.js';
+import { registerReferenceTools } from './refs.js';
 import { registerAnalyzerTools } from './analyzer.js';
 import { registerMeetingTools } from './meeting.js';
 import { registerFlowchartTools } from './flowchart.js';
@@ -29,11 +30,12 @@ export function registerTools(server, projectId, user, onProjectChange) {
     registerStatusTool(server, ctx);
     // 📚 知识
     registerProjectTools(server, ctx);
-    registerRuleTools(server, ctx);
+    registerWorkflowTools(server, ctx);
     // 📝 工作流
     registerTaskTools(server, ctx);
     registerFileTools(server);
     registerDiscussionTools(server, ctx);
+    registerReferenceTools(server);
     // 🔬 代码分析
     registerAnalyzerTools(server, ctx);
     // 🏛️ 多AI协作

package/dist/tools/refs.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerReferenceTools(server: McpServer): void;

package/dist/tools/refs.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import { getClient } from '../storage/httpClient.js';
+import { decodeObjectStrings } from '../utils.js';
+import { safeTool, wrap } from './shared.js';
+const linkSchema = z.object({
+    url: z.string(),
+    label: z.string(),
+});
+const fileSchema = z.object({
+    name: z.string(),
+    path: z.string(),
+});
+const adoptedNodeSchema = z.object({
+    chartId: z.string(),
+    nodeId: z.string(),
+    nodeLabel: z.string(),
+});
+export function registerReferenceTools(server) {
+    const client = () => getClient();
+    server.tool('kg_ref', '📎 外部参考 — 管理项目引用的第三方资料、链接、脚本和样例文件。\n' +
+        '涉及参考资料时主动调用：list 查看已有 → get 读详情 → read_file 读附件内容 → save 新增。\n' +
+        'actions: list|get|save|delete|read_file', {
+        action: z.enum(['list', 'get', 'save', 'delete', 'read_file']).describe('操作类型'),
+        id: z.string().optional().describe('参考 ID'),
+        title: z.string().optional().describe('参考标题 (save)'),
+        summary: z.string().optional().describe('Markdown 总结 (save)'),
+        links: z.array(linkSchema).optional().describe('参考链接 (save)'),
+        files: z.array(fileSchema).optional().describe('参考文件 (save)'),
+        scripts: z.array(fileSchema).optional().describe('解析脚本 (save)'),
+        adoptedBy: z.array(adoptedNodeSchema).optional().describe('已采用该参考的节点 (save)'),
+        path: z.string().optional().describe('参考文件路径 (read_file)'),
+    }, async (args) => safeTool(async () => {
+        const decoded = decodeObjectStrings(args);
+        switch (decoded.action) {
+            case 'list': {
+                const refs = await client().listReferences();
+                if (refs.length === 0)
+                    return wrap('当前没有外部参考');
+                const lines = [
+                    `📎 外部参考 (${refs.length})`,
+                    '',
+                    '| ID | 标题 | 链接 | 文件 | 已采用 |',
+                    '|:---|:---|---:|---:|---:|',
+                ];
+                for (const ref of refs) {
+                    lines.push(`| ${ref.id} | ${ref.title} | ${ref.links.length} | ${ref.files.length} | ${ref.adoptedBy.length} |`);
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'get': {
+                if (!decoded.id)
+                    return wrap('❌ get 需要 id');
+                const ref = await client().getReference(decoded.id);
+                if (!ref)
+                    return wrap(`未找到外部参考: ${decoded.id}`);
+                const lines = [
+                    `# ${ref.title}`,
+                    '',
+                    `- ID: ${ref.id}`,
+                    `- Links: ${ref.links.length}`,
+                    `- Files: ${ref.files.length}`,
+                    `- Scripts: ${ref.scripts.length}`,
+                    `- AdoptedBy: ${ref.adoptedBy.length}`,
+                    '',
+                    ref.summary || '(无摘要)',
+                ];
+                if (ref.links.length > 0) {
+                    lines.push('', '## Links');
+                    for (const link of ref.links) {
+                        lines.push(`- ${link.label}: ${link.url}`);
+                    }
+                }
+                if (ref.files.length > 0) {
+                    lines.push('', '## Files');
+                    for (const file of ref.files) {
+                        lines.push(`- ${file.name}: ${file.path}`);
+                    }
+                }
+                if (ref.scripts.length > 0) {
+                    lines.push('', '## Scripts');
+                    for (const script of ref.scripts) {
+                        lines.push(`- ${script.name}: ${script.path}`);
+                    }
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'save': {
+                if (!decoded.id)
+                    return wrap('❌ save 需要 id');
+                if (!decoded.title)
+                    return wrap('❌ save 需要 title');
+                const existing = await client().getReference(decoded.id);
+                const now = new Date().toISOString();
+                await client().saveReference({
+                    id: decoded.id,
+                    title: decoded.title,
+                    summary: decoded.summary || existing?.summary || '',
+                    links: decoded.links || existing?.links || [],
+                    files: decoded.files || existing?.files || [],
+                    scripts: decoded.scripts || existing?.scripts || [],
+                    adoptedBy: decoded.adoptedBy || existing?.adoptedBy || [],
+                    createdAt: existing?.createdAt || now,
+                    updatedAt: now,
+                });
+                return wrap(`✅ 外部参考已保存 (${decoded.id})`);
+            }
+            case 'delete': {
+                if (!decoded.id)
+                    return wrap('❌ delete 需要 id');
+                const ok = await client().deleteReference(decoded.id);
+                return wrap(ok ? `✅ 外部参考已删除 (${decoded.id})` : `ℹ️ 未找到外部参考 (${decoded.id})`);
+            }
+            case 'read_file': {
+                if (!decoded.path)
+                    return wrap('❌ read_file 需要 path');
+                const content = await client().readReferenceFile(decoded.path);
+                return wrap(content);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
+        }
+    }));
+}

package/dist/tools/tasks.js

@@ -184,14 +184,14 @@ export function registerTaskTools(server, ctx) {
                     return wrap('归档失败(任务不存在或已归档)');
                 return wrap(`✅ 任务已归档: ${task.title}`);
             }
-            default:
-                return wrap(`❌ 未知 action: ${decoded.action}`);
             case 'delete': {
                 if (!decoded.taskId)
                     return wrap('❌ delete 需要 taskId');
                 const ok = await client().deleteTask(decoded.taskId);
                 return wrap(ok ? `✅ 任务已删除 (ID: ${decoded.taskId})` : '❌ 删除失败(任务不存在)');
             }
+            default:
+                return wrap(`❌ 未知 action: ${decoded.action}`);
         }
     }));
 }

package/dist/tools/workflow.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpContext } from './shared.js';
+export declare function registerWorkflowTools(server: McpServer, _ctx: McpContext): void;

package/dist/tools/workflow.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { getClient } from '../storage/httpClient.js';
+import { decodeObjectStrings } from '../utils.js';
+import { safeTool, wrap } from './shared.js';
+export function registerWorkflowTools(server, _ctx) {
+    const client = () => getClient();
+    server.tool('kg_workflow', '📘 文档工作流 — AI 的标准操作手册。每个工作流是一份 Markdown 文档，定义了特定场景下 AI 应该遵循的步骤和规范。\n' +
+        '调用方式：空参数=列出所有工作流；传 id=获取工作流正文；save/delete 需显式 action。\n' +
+        '典型用法：拿到任务后先 kg_workflow() 看有无相关工作流，有则 kg_workflow(id:"xxx") 读取并遵循执行。', {
+        action: z.enum(['list', 'get', 'save', 'delete']).optional().describe('省略时自动推断：无参数=list，有id=get'),
+        id: z.string().optional().describe('工作流 ID'),
+        scope: z.enum(['all', 'global', 'project']).optional().describe('范围：all(默认)|global|project'),
+        title: z.string().optional().describe('标题 (save 必填)'),
+        content: z.string().optional().describe('Markdown 正文 (save 必填)'),
+    }, async (args) => safeTool(async () => {
+        const decoded = decodeObjectStrings(args);
+        const action = decoded.action ?? (decoded.id ? 'get' : 'list');
+        if (!decoded.action && (decoded.title !== undefined || decoded.content !== undefined)) {
+            return wrap('❌ save/delete 需要显式传 action');
+        }
+        switch (action) {
+            case 'list': {
+                const workflows = await client().listWorkflows(decoded.scope ?? 'all');
+                if (workflows.length === 0)
+                    return wrap('当前没有可用文档工作流');
+                const lines = [
+                    `📘 文档工作流列表 (${workflows.length})`,
+                    '',
+                    '| ID | 范围 | 标题 |',
+                    '|:---|:---|:---|',
+                ];
+                for (const w of workflows) {
+                    lines.push(`| ${w.id} | ${w.scope} | ${w.title} |`);
+                }
+                return wrap(lines.join('\n'));
+            }
+            case 'get': {
+                if (!decoded.id)
+                    return wrap('❌ get 需要 id');
+                const doc = await client().getWorkflow(decoded.id, decoded.scope ?? 'all');
+                if (!doc)
+                    return wrap(`未找到工作流: ${decoded.id}`);
+                return wrap([
+                    `# ${doc.title}`,
+                    `> ID: ${doc.id} | 范围: ${doc.scope}`,
+                    '',
+                    doc.content,
+                ].join('\n'));
+            }
+            case 'save': {
+                if (!decoded.id)
+                    return wrap('❌ save 需要 id');
+                if (!decoded.title)
+                    return wrap('❌ save 需要 title');
+                if (!decoded.content)
+                    return wrap('❌ save 需要 content');
+                const doc = await client().saveWorkflow(decoded.id, {
+                    scope: decoded.scope === 'global' ? 'global' : 'project',
+                    title: decoded.title,
+                    description: '',
+                    system: '',
+                    keywords: [],
+                    minHits: 0,
+                    always: false,
+                    content: decoded.content,
+                });
+                return wrap(`✅ 已保存: ${doc.scope}/${doc.id} — ${doc.title}`);
+            }
+            case 'delete': {
+                if (!decoded.id)
+                    return wrap('❌ delete 需要 id');
+                const scope = decoded.scope === 'global' ? 'global' : 'project';
+                const ok = await client().deleteWorkflow(decoded.id, scope);
+                return wrap(ok ? `✅ 已删除 ${scope}/${decoded.id}` : `未找到 ${scope}/${decoded.id}`);
+            }
+            default:
+                return wrap(`❌ 未知 action: ${String(decoded.action)}`);
+        }
+    }));
+}

package/dist/utils.d.ts

@@ -1,12 +1,6 @@
 /**
  * MCP Server 工具函数
  */
-export type RuleType = string;
-export declare const RULE_TYPE_LABELS: Record<string, string>;
-/**
- * 获取指定类型的规则 (动态: 从 meta 获取标签)
- */
-export declare function getRules(projectId: string, ruleType?: string): Promise<string>;
 /**
  * 解码 Unicode 转义序列
  * 将 \uXXXX 格式的转义序列转换为实际字符

package/dist/utils.js

@@ -1,50 +1,6 @@
 /**
  * MCP Server 工具函数
  */
-import { getClient } from './storage/httpClient.js';
-// 默认规则类型标签 (fallback)
-const DEFAULT_LABELS = {
-    userStyles: '用户沟通规则',
-    codeStyle: '编码风格规则',
-    reviewRules: '代码审查规则',
-    testRules: '错误分析规则',
-    unitTests: '代码测试规则',
-};
-// 兼容导出
-export const RULE_TYPE_LABELS = DEFAULT_LABELS;
-/**
- * 将字符串数组格式化为 Markdown 列表
- */
-function formatRulesList(rules) {
-    if (!rules || rules.length === 0)
-        return '';
-    return rules.map((s, i) => `${i + 1}. ${s}`).join('\n\n');
-}
-/**
- * 获取指定类型的规则 (动态: 从 meta 获取标签)
- */
-export async function getRules(projectId, ruleType) {
-    const client = getClient();
-    const meta = await client.getRulesMeta();
-    if (ruleType) {
-        const rules = await client.getRulesApi(ruleType);
-        if (!rules || rules.length === 0)
-            return '';
-        const label = meta[ruleType]?.label || DEFAULT_LABELS[ruleType] || ruleType;
-        return `[${label}]\n${formatRulesList(rules)}`;
-    }
-    // 返回所有规则 (从 meta 获取所有类型)
-    const types = Object.keys(meta).length > 0 ? Object.keys(meta) : Object.keys(DEFAULT_LABELS);
-    const allRules = [];
-    for (const type of types) {
-        const rules = await client.getRulesApi(type);
-        if (rules && rules.length > 0) {
-            const label = meta[type]?.label || DEFAULT_LABELS[type] || type;
-            allRules.push(`[${label}]\n${formatRulesList(rules)}`);
-        }
-    }
-    return allRules.join('\n\n---\n\n');
-}
 /**
  * 解码 Unicode 转义序列
  * 将 \uXXXX 格式的转义序列转换为实际字符

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.37",
+  "version": "3.3.0",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",
@@ -33,15 +33,11 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "adm-zip": "^0.5.16",
-    "archiver": "^7.0.1",
-    "chokidar": "^5.0.0",
     "express": "^5.1.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {
     "@types/adm-zip": "^0.5.7",
-    "@types/archiver": "^7.0.0",
-    "@types/chokidar": "^1.7.5",
     "@types/express": "^5.0.0",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0"

package/templates/AGENT.md

@@ -12,9 +12,10 @@ kg_discuss(action:"list") -> ???????
 ## 1. ????????
 
 - ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
-- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_workflow()` / `kg_workflow(id:"...")` / `kg_workflow(action:"save|delete")`
 - ??: `kg_task(action:"create|get|update|archive|delete")`
 - ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??: `kg_ref(action:"list|get|save|delete|read_file")`
 - ??/??: `kg_discuss(...)`, `kg_meeting(...)`
 - ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
 - ????: ?????????????????????????????? fallback????????????
@@ -22,7 +23,7 @@ kg_discuss(action:"list") -> ???????
 ## 2. ?????
 
 ### Step 1: ????
-1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+1. ?? `kg_flowchart(get)` ????????? `kg_workflow()` ?????
 2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
 3. ????? `subFlowchart`???????????????
 4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?

package/templates/README.md

@@ -6,7 +6,7 @@
 
 | 文件 | 用途 | 目标路径 |
 |-----|------|---------|
-| `hooks/hook.py` | 动态规则触发脚本 (关键词匹配 + 批量获取) | `.claude/hooks/hook.py` |
+| `hooks/hook.py` | 动态文档工作流触发脚本 (关键词匹配 + 批量获取) | `.claude/hooks/hook.py` |
 | `hooks/SystemPrompt.md` | 系统提示词模板 | `.claude/hooks/SystemPrompt.md` |
 | `commands/pp/` | Claude Code 自定义命令 | `.claude/commands/pp/` |
 | `AGENT.md` | Codex/通用 Agent 提示词 | `./AGENTS.md` |
@@ -45,7 +45,7 @@ CLI 通过 `detectIDEs()` 扫描项目目录，自动为检测到的 IDE 安装
 ## Hook 触发机制
 
 ```
-用户输入 → hook.py → GET /rules-meta → 关键词匹配 → POST /rules/batch → 输出规则
+用户输入 → hook.py → GET /workflows → 关键词匹配 → POST /workflows/batch → 输出工作流
 ```
 
 hooks 配置由 CLI 动态生成 (`generateHooksConfig()`)，无需静态模板文件。

package/templates/commands/pp/diagnose.md

@@ -21,7 +21,7 @@
 ```
 kg_flowchart(action:"list")        → 知识图谱列表
 kg_flowchart(action:"get")         → 主图结构 (模块 + 连线)
-kg_rules(action:"get", ruleType:"errorAnalysis") → 错误分析规则
+kg_workflow(id:"review-audit") → 诊断工作流
 ```
 
 **1.2 关键词定位模块**
@@ -68,7 +68,7 @@ Step 3: 输出疑点路径
 
 ```
 code_smart_context(嫌疑符号名)
-  → 代码依赖 + 关联文档 + 匹配规则 + 影响范围摘要
+  → 代码依赖 + 关联文档 + 匹配工作流 + 影响范围摘要
 
 code_impact(嫌疑符号名)
   → L1 直接引用 (必须检查)
@@ -164,7 +164,7 @@ L2: 2个间接调用方可能受影响
 |:---|:---|:---|
 | 锚定 | `kg_flowchart(list/get)` | 全景鸟瞰 |
 | 锚定 | `kg_flowchart(get)` | 主图结构 |
-| 锚定 | `kg_rules(get)` | 分析规则 |
+| 锚定 | `kg_workflow()` / `kg_workflow(id:"...")` | 分析工作流 |
 | 下探 | `kg_flowchart(get_node, expand:N)` | 节点详情+上下游 |
 | 下探 | `kg_flowchart(get, chartId:子图)` | 进入子图 |
 | 半径 | `code_smart_context(symbol)` | 全关联上下文 |

package/templates/commands/pp/review.md

@@ -4,7 +4,7 @@
 
 | 原则 | 要求 |
 |:---|:---|
-| **规则驱动** | 必须先加载 kg_rules, 以项目规则为审查标准 |
+| **工作流驱动** | 必须先加载 kg_workflow, 以 Markdown 工作流为审查标准 |
 | **4维并行** | 逻辑/清洁/极简/图谱一致性 同时扫描 |
 | **零容忍** | 任一维度 CRITICAL 即驳回, 不存在"下次再改" |
 | **健康闭环** | 审查必须包含图谱健康检查, 确保知识库同步 |
@@ -26,11 +26,10 @@
 ### Phase 0: 加载审查标准
 
 ```
-kg_rules(action:"get", ruleType:"reviewRules")  → 审查规则
-kg_rules(action:"get", ruleType:"codeStyle")    → 编码风格
-kg_rules(action:"get", ruleType:"errorAnalysis") → 错误分析规则
+kg_workflow(id:"review-audit")   → 审查/诊断工作流
+kg_workflow(id:"common-general") → 通用执行工作流
 ```
-将获取的规则作为本次审查的量化标准。
+将获取的文档工作流作为本次审查的量化标准。
 
 **确定审查范围**:
 ```
@@ -75,7 +74,7 @@ Bash: git log --oneline -3         → 近期提交
 
 #### C. 极简架构
 ```
-对照 codeStyle 规则逐条检查:
+对照已加载文档工作流中的编码约束逐条检查:
   × 函数超50行                              → 🟡 拆分建议
   × 嵌套超3层                               → 🟡 扁平化建议
   × 重复造轮子 (code_query 搜索已有实现)      → 🔴
@@ -144,9 +143,9 @@ kg_flowchart(action:"health")
 **概览**: 评分 85/100 | 🔴 0 | 🟡 2 | 🔵 1
 **状态**: ✅ 通过 / ❌ 驳回
 
-**应用规则**:
-- reviewRules: 已加载 N 条
-- codeStyle: 已加载 M 条
+**应用文档工作流**:
+- review-audit: 已加载
+- common-general: 已加载
 
 **逻辑验证图** (A维度):
 [用户输入] → [参数校验] → [业务处理] → [返回结果] ✅ 闭环
@@ -174,7 +173,7 @@ kg_flowchart(action:"health")
 
 | 阶段 | 工具 | 用途 |
 |:---|:---|:---|
-| 加载 | `kg_rules(get)` | 审查规则/编码风格 |
+| 加载 | `kg_workflow(id:"...")` | 审查/执行工作流 |
 | 范围 | `code_context(file)` | 变更文件的依赖 |
 | A逻辑 | 人工推演 + ASCII图 | 逻辑闭环验证 |
 | B清洁 | `Grep(pattern)` | 死代码/调试残留扫描 |

package/templates/cursorrules.md

@@ -12,9 +12,10 @@ kg_discuss(action:"list") -> ???????
 ## 1. ????????
 
 - ??: `kg_flowchart(action:"list|get|get_node|update_node|delete_node|batch_add|bind|unbind|orphans|health|create_chart|delete_chart")`
-- ??: `kg_rules(action:"get|save|get_meta|save_meta")`
+- ??: `kg_workflow()` / `kg_workflow(id:"...")` / `kg_workflow(action:"save|delete")`
 - ??: `kg_task(action:"create|get|update|archive|delete")`
 - ??: `kg_files(action:"list|read|upload|download|public_*")`
+- ??: `kg_ref(action:"list|get|save|delete|read_file")`
 - ??/??: `kg_discuss(...)`, `kg_meeting(...)`
 - ????: `code_scan()`, `code_smart_context(symbolName)`, `code_full_path(symbolA, symbolB)`
 - ????: ?????????????????????????????? fallback????????????
@@ -22,7 +23,7 @@ kg_discuss(action:"list") -> ???????
 ## 2. ?????
 
 ### Step 1: ????
-1. ?? `kg_flowchart(get)` ????????? `kg_rules(get)` ?????
+1. ?? `kg_flowchart(get)` ????????? `kg_workflow()` ?????
 2. ???????? `kg_flowchart(get_node, expand:2, includeDoc:true, includeFiles:true)`?
 3. ????? `subFlowchart`???????????????
 4. ??????????? `code_scan()`??? `code_smart_context` / `code_full_path`?

package/templates/hooks/SystemPrompt.md

@@ -8,7 +8,7 @@
 |:---|:---|
 | **知识图谱中心** | 方案制定前检索图谱+代码双重验证；任务结束提示沉淀至图谱 |
 | **任务驱动开发** | 复杂任务必须 `kg_task(action:"create")`；过程记录 `kg_task(action:"update")`；完成 `kg_task(action:"archive")` |
-| **规则引用** | 编码前读 `codeStyle`；测试前读 `testRules`；审查前读 `reviewRules` |
+| **工作流引用** | 先 `kg_workflow()` 查看当前可用文档工作流；执行前优先读 `common-general`，审查/诊断前优先读 `review-audit` |
 | **绝对真实性** | 禁用 faker/模拟数据，必须真实环境验证 |
 | **沟通可视化** | 禁纯文字/Mermaid代码；强制 ASCII流程图 + Markdown表格 |
 | **极简模块化** | 拆解为原子函数，清理注释旧代码/Debug日志 |
@@ -33,14 +33,14 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 ### Step 1: 分析与澄清
 1. 接收需求，识别意图
 2. `kg_flowchart(action:"search", query:"关键词")` 检索现有节点/历史坑点
-3. `kg_rules(action:"get")` 获取项目规则
+3. `kg_workflow()` 获取全局/项目文档工作流，按需 `kg_workflow(id:"common-general")`
 4. 有歧义则列选项供用户选择
 
 **输出**: 需求确认清单 (表格)
 
 ### Step 2: 逻辑设计
 1. 结合图谱+代码设计方案
-2. `kg_rules(action:"get", ruleType:"codeStyle")` 确认编码规范
+2. `kg_workflow(id:"common-general")` 确认通用执行工作流
 3. 检查现有复用函数，拒绝重复建设
 4. 大型任务: `kg_task(action:"create")`
 
@@ -51,13 +51,13 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 **前置**: 用户确认方案
 1. `kg_task(action:"update", log_type:"progress", content:"开始编码")`
 2. 优先编写/更新工具函数，再业务组装
-3. 遵循 codeStyle 规则
+3. 遵循已加载文档工作流中的编码约束
 4. 清理现场，无残留代码
 
 **输出**: 结构清晰的代码
 
 ### Step 4: 真实验证
-1. `kg_rules(action:"get", ruleType:"testRules")` 获取测试规则
+1. `kg_workflow(id:"review-audit")` 获取验证/诊断工作流
 2. 在 `tests/` 对应目录创建测试
 3. 真实环境运行，验证输出
 4. 失败时: `kg_task(action:"update", log_type:"issue", content:"xxx失败")` → 回溯Step2
@@ -65,7 +65,7 @@ kg_task(action:"create") → kg_task(action:"update", log_type:"progress|issue|s
 **严禁**: "测试环境所以失败"借口
 
 ### Step 5: 审查与沉淀
-1. `kg_rules(action:"get", ruleType:"reviewRules")` 获取审查规则
+1. `kg_workflow(id:"review-audit")` 获取审查工作流
 2. 审查目录结构/代码简洁度
 3. 发现BUG → `kg_flowchart(action:"update_node")` 回写节点说明与文档
 4. 新逻辑 → `kg_flowchart(action:"batch_add")` 新增节点，或 `kg_flowchart(action:"update_node")` 追加文档/版本