@ppdocs/mcp 3.2.18 → 3.2.20

package/templates/commands/pp/execute.md

@@ -0,0 +1,84 @@
+# ⚡️ "Ockham's Blade" Execution Protocol (奥卡姆之刃执行协议)
+
+该工作流旨在执行已确认的方案。核心原则：**拒绝冗余，一行搞定，模块解耦，逻辑确权。**
+
+---
+
+### 1.第一阶段：逻辑确权 (Knowledge Anchor) 🧠
+🔹 **核心目标**：消除所有不确定性，确保逻辑绝对正确。
+✏️ **动作**：
+*   解析任务需求。
+*   遇到模糊逻辑，立即查询**知识图谱 (Knowledge Graph)** 确认标准流程。
+× **禁区**：
+*   禁止基于猜测编写代码。
+*   禁止模糊定义的变量。
+
+### 2.第二阶段：架构定义 (Structure & Taxonomy) 🏗️
+🔹 **核心目标**：目录清晰，分类准确，模块独立。
+✏️ **动作**：
+*   构建标准目录树 (Directory Tree)。
+*   定义原子化模块 (Atomic Modules)。
+*   确保接口通用，支持复用调用。
+× **禁区**：
+*   禁止模块间产生强耦合 (Zero Coupling)。
+*   禁止混乱的文件层级。
+
+### 3.第三阶段：极简实现 (Minimalist Coding) 🚀
+🔹 **核心目标**：不造轮子，极致压缩代码行数。
+✏️ **动作**：
+*   最大化调用现有库与复用功能。
+*   利用链式调用、推导式等语法特性。
+× **禁区**：
+*   **能一行代码解决的问题，严格禁止使用第二行。**
+*   禁止重复造轮子 (DRY Principle)。
+
+### 4.第四阶段：最终交付 (Delivery) 📦
+🔹 **核心目标**：输出可直接运行、可维护的成果。
+✏️ **动作**：
+*   输出标准化的文件结构。
+*   交付模块化源码。
+
+---
+
+### 📊 执行逻辑可视化图解 (ASCII)
+
+```text
+       +-----------------------+
+       |   🚀 任务启动 (Start)  |
+       +-----------+-----------+
+                   |
+                   v
+       +-----------+-----------+
+       |  🧠 逻辑是否清晰?      | <-----+
+       +-----------+-----------+       |
+        (❌ NO)    | (✅ YES)         |
+          |        v                   |
+   +------+-----+  +----------------+  |
+   | 🔍 查图谱   |  | 🏗️ 架构设计     |  |
+   +------------+  +-------+--------+  |
+                           |           |
+                           v           |
+                   +-------+--------+  |
+                   | ♻️ 存在轮子?    |  |
+                   +-------+--------+  |
+                  /                  \ |
+            (YES)/                    \(NO)
+                v                      v
+        +-------+-------+      +-------+-------+
+        | ✏️ 直接调用    |      | ✏️ 原子编写    |
+        +-------+-------+      +-------+-------+
+                |                      |
+                +----------+-----------+
+                           |
+                           v
+                   +-------+-------+
+                   | 📏 极简审查    | <-----+
+                   +-------+-------+       |
+                           |               |
+               /-----------+----------\    |
+              /    是否多于一行?       \   |
+             v                          v  |
+     +-------+-------+          +-------+--+----+
+     | ✅ 达标        |          | × 删减 (Trim) |
+     | (Delivery)    |          |   压缩代码     |
+     +---------------+          +---------------+

package/templates/hooks/SystemPrompt.md

@@ -1,5 +1,8 @@
 你是严谨的软件架构师，围绕**用户知识图谱软件**工作，确保每个变动有据可查，每次成功沉淀为知识节点。
 
+## 会话启动检查
+每次会话开始时, 执行 `kg_discuss({ action: "list" })` 检查是否有涉及本项目的待回复讨论。如有, 主动提醒用户: "发现 N 条待处理讨论, 是否需要查看?"
+
 ## 核心宪法
 | 原则 | 要求 |
 |:---|:---|
@@ -100,3 +103,16 @@ task_create → task_add_log(progress/issue/solution/reference) → task_complet
 |:---|:---|:---|:---|
 | 复用 | 重复造轮子 | 调用utils | 无 |
 | 结构 | 混杂views | 迁移services | 需改引用 |
+
+---
+
+## 工作流速查
+| 命令 | 用途 | 场景 |
+|:---|:---|:---|
+| `/pp:init` | 项目知识图谱初始化 | 新项目接入 |
+| `/pp:sync` | 代码↔知识图谱同步 | 代码变更后 |
+| `/pp:diagnose` | 深度问题诊断 | 排查 Bug |
+| `/pp:execute` | 任务极简执行 | 已确认方案的编码 |
+| `/pp:review` | 代码质量审查 | 轻量级审查 |
+| `/pp:audit` | 多Agent严格审计 | 重要交付前 |
+| `/pp:discuss` | 讨论响应与协作 | 跨项目协商 |

package/dist/storage/discussion.d.ts

@@ -1,33 +0,0 @@
-export interface DiscussionMessage {
-    id: string;
-    sender: string;
-    content: string;
-    timestamp: string;
-}
-export interface DiscussionTopic {
-    id: string;
-    title: string;
-    initiator: string;
-    participants: string[];
-    summary: string;
-    status: 'active' | 'completed';
-    created_at: string;
-    updated_at: string;
-    messages: DiscussionMessage[];
-}
-export declare class DiscussionManager {
-    private static getFilePath;
-    private static readAll;
-    private static writeAll;
-    static listActive(): Omit<DiscussionTopic, 'messages'>[];
-    static readByIds(ids: string[]): DiscussionTopic[];
-    static create(title: string, initiator: string, participants: string[], content: string): string;
-    static reply(id: string, sender: string, content: string, newSummary?: string): boolean;
-    static getAndRemove(id: string): DiscussionTopic | null;
-    /** 按ID删除讨论（不归档，直接删除） */
-    static delete(id: string): boolean;
-    /** 清理过期讨论（默认7天不活跃） */
-    static cleanExpired(days?: number): number;
-    /** 获取活跃讨论数量 */
-    static activeCount(): number;
-}

package/dist/storage/discussion.js

@@ -1,116 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-export class DiscussionManager {
-    static getFilePath() {
-        const dir = path.join(os.homedir(), '.ppdocs');
-        if (!fs.existsSync(dir))
-            fs.mkdirSync(dir, { recursive: true });
-        return path.join(dir, 'discussions.json');
-    }
-    static readAll() {
-        try {
-            const file = this.getFilePath();
-            if (!fs.existsSync(file))
-                return [];
-            return JSON.parse(fs.readFileSync(file, 'utf-8'));
-        }
-        catch {
-            return [];
-        }
-    }
-    static writeAll(data) {
-        fs.writeFileSync(this.getFilePath(), JSON.stringify(data, null, 2), 'utf-8');
-    }
-    static listActive() {
-        return this.readAll()
-            .filter(t => t.status === 'active')
-            .map(({ messages, ...rest }) => rest);
-    }
-    static readByIds(ids) {
-        return this.readAll().filter(t => ids.includes(t.id));
-    }
-    static create(title, initiator, participants, content) {
-        const id = `req_${Math.random().toString(36).substring(2, 9)}`;
-        const now = new Date().toISOString();
-        // 确保发起方始终在参与列表中
-        const allParticipants = participants.includes(initiator) ? [...participants] : [initiator, ...participants];
-        const topic = {
-            id,
-            title,
-            initiator,
-            participants: allParticipants,
-            summary: "等待各方回复中...",
-            status: 'active',
-            created_at: now,
-            updated_at: now,
-            messages: [{
-                    id: `msg_${Math.random().toString(36).substring(2, 9)}`,
-                    sender: initiator,
-                    content,
-                    timestamp: now
-                }]
-        };
-        const all = this.readAll();
-        all.push(topic);
-        this.writeAll(all);
-        return id;
-    }
-    static reply(id, sender, content, newSummary) {
-        const all = this.readAll();
-        const topic = all.find(t => t.id === id);
-        if (!topic || topic.status !== 'active')
-            return false;
-        const now = new Date().toISOString();
-        topic.messages.push({
-            id: `msg_${Math.random().toString(36).substring(2, 9)}`,
-            sender,
-            content,
-            timestamp: now
-        });
-        topic.updated_at = now;
-        if (newSummary) {
-            topic.summary = newSummary;
-        }
-        // Auto add to participants if not exists
-        if (!topic.participants.includes(sender)) {
-            topic.participants.push(sender);
-        }
-        this.writeAll(all);
-        return true;
-    }
-    static getAndRemove(id) {
-        const all = this.readAll();
-        const index = all.findIndex(t => t.id === id);
-        if (index === -1)
-            return null;
-        const topic = all.splice(index, 1)[0];
-        this.writeAll(all);
-        return topic;
-    }
-    /** 按ID删除讨论（不归档，直接删除） */
-    static delete(id) {
-        const all = this.readAll();
-        const index = all.findIndex(t => t.id === id);
-        if (index === -1)
-            return false;
-        all.splice(index, 1);
-        this.writeAll(all);
-        return true;
-    }
-    /** 清理过期讨论（默认7天不活跃） */
-    static cleanExpired(days = 7) {
-        const all = this.readAll();
-        const cutoff = Date.now() - days * 86400000;
-        const before = all.length;
-        const filtered = all.filter(t => new Date(t.updated_at).getTime() > cutoff);
-        if (filtered.length < before) {
-            this.writeAll(filtered);
-        }
-        return before - filtered.length;
-    }
-    /** 获取活跃讨论数量 */
-    static activeCount() {
-        return this.readAll().filter(t => t.status === 'active').length;
-    }
-}