@ppdocs/mcp 3.2.29 → 3.2.31

package/dist/cli.js

@@ -486,37 +486,53 @@ function installClaudeTemplates(cwd) {
     fs.writeFileSync(settingsPath, JSON.stringify(mergedSettings, null, 2));
     console.log(`✅ Configured .claude/settings.json hooks (${process.platform})`);
     console.log(`✅ Added ${mcpPermissions.length} MCP method permissions`);
-    // 4. 安装工作流到 .agents/workflows/ (全平台通用)
+    // 4. 生成 CLAUDE.md 全局规则 (Claude Code 官方标准)
+    installGlobalRules(cwd, 'CLAUDE.md');
+    // 5. 安装工作流到 .agents/workflows/ (全平台通用)
     installWorkflows(cwd);
 }
 /** 安装 Codex 模板 (生成 AGENTS.md + 工作流) */
 function installCodexTemplates(cwd) {
-    generateAgentsMd(cwd);
+    installGlobalRules(cwd, 'AGENTS.md');
     installWorkflows(cwd);
 }
-/** 生成 AGENTS.md 工具函数 (去重) */
-function generateAgentsMd(cwd) {
-    const srcPrompt = path.join(TEMPLATES_DIR, 'hooks', 'SystemPrompt.md');
-    const destAgents = path.join(cwd, 'AGENTS.md');
-    if (fs.existsSync(srcPrompt) && !fs.existsSync(destAgents)) {
-        fs.copyFileSync(srcPrompt, destAgents);
-        console.log(`✅ Created AGENTS.md`);
+/**
+ * 生成全局规则文件 (各平台统一内容, 不同文件名)
+ * Claude Code → CLAUDE.md | Codex → AGENTS.md | Gemini → GEMINI.md
+ */
+function installGlobalRules(cwd, filename) {
+    const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
+    const destFile = path.join(cwd, filename);
+    if (fs.existsSync(srcRules)) {
+        // 总是覆盖写入最新版全局规则
+        fs.copyFileSync(srcRules, destFile);
+        console.log(`✅ Installed ${filename} (global rules)`);
     }
-    else if (!fs.existsSync(srcPrompt)) {
-        console.log(`⚠️  SystemPrompt.md template not found`);
+    else {
+        console.log(`⚠️  Global rules template not found`);
     }
 }
 /** 安装 Cursor 模板 */
 function installCursorTemplates(cwd, apiUrl, user) {
     createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl, { user });
-    // 2. 生成 .cursorrules 提示词
+    // 2. 生成 .cursor/rules/ppdocs.md (官方标准, .cursorrules 已废弃)
+    const cursorRulesDir = path.join(cwd, '.cursor', 'rules');
+    if (!fs.existsSync(cursorRulesDir)) {
+        fs.mkdirSync(cursorRulesDir, { recursive: true });
+    }
     const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
-    const destRules = path.join(cwd, '.cursorrules');
-    if (fs.existsSync(srcRules) && !fs.existsSync(destRules)) {
+    const destRules = path.join(cursorRulesDir, 'ppdocs.md');
+    if (fs.existsSync(srcRules)) {
         fs.copyFileSync(srcRules, destRules);
-        console.log(`✅ Created .cursorrules`);
+        console.log(`✅ Installed .cursor/rules/ppdocs.md`);
     }
-    // 3. 安装工作流到 .agents/workflows/
+    // 3. 清理废弃的 .cursorrules 文件
+    const legacyCursorrules = path.join(cwd, '.cursorrules');
+    if (fs.existsSync(legacyCursorrules)) {
+        fs.unlinkSync(legacyCursorrules);
+        console.log(`🗑️  Removed deprecated .cursorrules`);
+    }
+    // 4. 安装工作流到 .agents/workflows/
     installWorkflows(cwd);
 }
 // ========================================================================
@@ -590,8 +606,8 @@ function installWorkflows(cwd, extraDirs = []) {
 function installAntigravityTemplates(cwd, apiUrl, user) {
     // Antigravity 由 gemini CLI 注册 env，文件配置不注入避免冲突
     createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true, user });
-    // 2. 生成 AGENTS.md
-    generateAgentsMd(cwd);
+    // 2. 生成 GEMINI.md 全局规则 (Gemini CLI 官方标准)
+    installGlobalRules(cwd, 'GEMINI.md');
     // 3. Antigravity 全局 workflows 目录 (额外安装目标)
     const homeDir = process.env.USERPROFILE || process.env.HOME || '';
     const globalWorkflowDir = path.join(homeDir, '.gemini', 'antigravity', 'global_workflows');
@@ -604,18 +620,24 @@ function installAntigravityTemplates(cwd, apiUrl, user) {
 /** 安装 Kiro 模板 */
 function installKiroTemplates(cwd, apiUrl, user) {
     createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl, { user });
-    // 2. 生成 Kiro Agent 规则
-    const kiroRulesDir = path.join(cwd, '.kiro', 'rules');
-    if (!fs.existsSync(kiroRulesDir)) {
-        fs.mkdirSync(kiroRulesDir, { recursive: true });
+    // 2. 生成 Kiro Steering 文件 (官方标准: .kiro/steering/ 而非 rules/)
+    const steeringDir = path.join(cwd, '.kiro', 'steering');
+    if (!fs.existsSync(steeringDir)) {
+        fs.mkdirSync(steeringDir, { recursive: true });
     }
     const srcRules = path.join(TEMPLATES_DIR, 'kiro-rules', 'ppdocs.md');
-    const destRules = path.join(kiroRulesDir, 'ppdocs.md');
-    if (fs.existsSync(srcRules) && !fs.existsSync(destRules)) {
-        fs.copyFileSync(srcRules, destRules);
-        console.log(`✅ Created .kiro/rules/ppdocs.md`);
-    }
-    // 3. 安装工作流到 .agents/workflows/
+    const destSteering = path.join(steeringDir, 'ppdocs.md');
+    if (fs.existsSync(srcRules)) {
+        fs.copyFileSync(srcRules, destSteering);
+        console.log(`✅ Installed .kiro/steering/ppdocs.md`);
+    }
+    // 3. 清理废弃的 .kiro/rules/ 旧路径
+    const legacyRules = path.join(cwd, '.kiro', 'rules', 'ppdocs.md');
+    if (fs.existsSync(legacyRules)) {
+        fs.unlinkSync(legacyRules);
+        console.log(`🗑️  Removed deprecated .kiro/rules/ppdocs.md`);
+    }
+    // 4. 安装工作流到 .agents/workflows/
     installWorkflows(cwd);
 }
 /** 检测当前工作区包含的 IDE */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.29",
+  "version": "3.2.31",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",

package/templates/cursorrules.md

@@ -26,6 +26,53 @@ kg_discuss(action:"list")                          → 检查待回复讨论
 
 ---
 
+## 方案制定 (第一性原理)
+
+**任何需求，先设计逻辑流程，再写代码。禁止跳过设计直接编码。**
+
+### Phase A: 第一性原理分析
+```
+1. 拆解需求本质: 这个功能的核心目的是什么？
+2. 识别输入/输出: 进什么 → 出什么？
+3. 查图谱现状:   kg_flowchart(get) → 哪些模块已存在可复用？
+4. 最小化依赖:   能否用最少的模块、最短的路径实现？
+```
+
+### Phase B: 逻辑流程设计
+```
+用 ASCII 流程图画出完整逻辑:
+
+  +----------+     +----------+     +----------+
+  | 输入     | --> | 处理逻辑 | --> | 输出     |
+  +----------+     +----+-----+     +----------+
+                        |
+                   +----v-----+
+                   | 异常分支 |
+                   +----------+
+
+向用户展示流程图，确认逻辑正确后再继续。
+```
+
+### Phase C: 细化逻辑节点
+```
+对流程图中每个节点，依次向下细化:
+  1. 定义接口: 输入参数 + 返回值
+  2. 选择实现: 复用现有 / 新建模块
+  3. 标注依赖: 上游数据来源 + 下游消费者
+  4. 异常处理: 每个节点的失败路径
+```
+
+### Phase D: 按流程执行 + 审查
+```
+按 Phase B 确认的逻辑流程，逐节点实现:
+  使用 Step 3 的逐步执行循环 (执行→验证→记录→回写)
+
+全部完成后:
+  对照逻辑流程图进行审查，确保实现与设计一致
+```
+
+---
+
 ## 标准执行流程
 
 ### Step 1: 知识锚定 (理解需求时)

package/templates/kiro-rules/ppdocs.md

@@ -26,6 +26,53 @@ kg_discuss(action:"list")                          → 检查待回复讨论
 
 ---
 
+## 方案制定 (第一性原理)
+
+**任何需求，先设计逻辑流程，再写代码。禁止跳过设计直接编码。**
+
+### Phase A: 第一性原理分析
+```
+1. 拆解需求本质: 这个功能的核心目的是什么？
+2. 识别输入/输出: 进什么 → 出什么？
+3. 查图谱现状:   kg_flowchart(get) → 哪些模块已存在可复用？
+4. 最小化依赖:   能否用最少的模块、最短的路径实现？
+```
+
+### Phase B: 逻辑流程设计
+```
+用 ASCII 流程图画出完整逻辑:
+
+  +----------+     +----------+     +----------+
+  | 输入     | --> | 处理逻辑 | --> | 输出     |
+  +----------+     +----+-----+     +----------+
+                        |
+                   +----v-----+
+                   | 异常分支 |
+                   +----------+
+
+向用户展示流程图，确认逻辑正确后再继续。
+```
+
+### Phase C: 细化逻辑节点
+```
+对流程图中每个节点，依次向下细化:
+  1. 定义接口: 输入参数 + 返回值
+  2. 选择实现: 复用现有 / 新建模块
+  3. 标注依赖: 上游数据来源 + 下游消费者
+  4. 异常处理: 每个节点的失败路径
+```
+
+### Phase D: 按流程执行 + 审查
+```
+按 Phase B 确认的逻辑流程，逐节点实现:
+  使用 Step 3 的逐步执行循环 (执行→验证→记录→回写)
+
+全部完成后:
+  对照逻辑流程图进行审查，确保实现与设计一致
+```
+
+---
+
 ## 标准执行流程
 
 ### Step 1: 知识锚定 (理解需求时)