@ppdocs/mcp 2.7.1 → 2.8.0

package/templates/commands/pp/Execution_Task.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/commands/pp/Sentinel_4.md

@@ -0,0 +1,87 @@
+# 🛡️ "Sentinel-4" 多智能体审计协议 任务成果审查或代码审查
+
+本工作流启用**4个独立智能体**并行工作，对任务成果进行“死刑级”严格审查。
+
+---
+
+### 1.智能体部署 (Agent Deployment) 🤖
+四个专家智能体同时介入，各司其职：
+
+#### 🕵️ 智能体 A：逻辑审计官 (Logic Auditor)
+*   **职责**：对照预期目标。
+*   **检查点**：
+    *   🔹 流程是否完全闭环？
+    *   🔹 是否存在逻辑断层？
+
+#### 🧹 智能体 B：代码清洁工 (Code Janitor)
+*   **职责**：通过静态分析寻找“垃圾”。
+*   **检查点**：
+    *   × **死代码 (Dead Code)**：检测未被调用的函数/变量。
+    *   × **新旧混合**：确保没有注释掉的旧逻辑残留。
+    *   × **冗余**：消除任何重复逻辑。
+
+#### ⚡ 智能体 C：极简架构师 (Minimalist Architect)
+*   **职责**：强制执行“单行原则”与模块化。
+*   **检查点**：
+    *   🔹 **解耦**：模块之间是否彻底分离？
+    *   🔹 **行数**：两行能写完的，是否用了三行？（臃肿判定）
+
+#### 📚 智能体 D：知识图谱守护者 (Graph Keeper)
+*   **职责**：真理一致性校验。
+*   **检查点**：
+    *   × **偏差**：代码逻辑是否违背了知识图谱中的标准定义？
+
+---
+
+### 2.综合裁决 (Synthesis & Verdict) ⚖️
+*   **汇总**：收集 4 个智能体的 Flag（报错）。
+*   **判定**：
+    *   只要有 **1个** 智能体亮红灯 🔴 -> **驳回重构**。
+    *   全员亮绿灯 🟢 -> **生成最终报告**。
+
+---
+
+### 3.最终交付：审查报告 (Final Report) 📝
+报告将以“简单自然语言 + 可视化图标”输出：
+*   **状态**：✅ 通过 / ❌ 驳回
+*   **评分**：代码纯净度 (0-100%)
+*   **风险点**：(如果有)
+*   **改进建议**：(针对性优化)
+
+---
+
+### 📊 审计流程可视化图解 (ASCII)
+
+```text
+               +----------------------+
+               |  📦 提交任务成果      |
+               +----------+-----------+
+                          |
+                          v
+               +----------+-----------+
+               |   ⚡  并行分发        |
+               +----------+-----------+
+             /      /     |     \      \
+            v      v      v      v      v
+      +--------+ +--------+ +--------+ +--------+
+      | 🕵️ A   | | 🧹 B   | | ⚡ C   | | 📚 D   |
+      | 逻辑   | | 代码   | | 极简   | | 图谱   |
+      +--------+ +--------+ +--------+ +--------+
+           |        |        |        |
+           +--------+--------+--------+
+                    |
+                    v
+           +--------+--------+
+           |  ⚖️ 综合裁决     |
+           +--------+--------+
+                    |
+            /-------+-------\
+           /    发现问题?    \
+          v                   v
+  +-----------+         +------------+
+  | ❌ 驳回    |         | 📝 生成报告 |
+  | (Reject)  |         | (Success)  |
+  +-----------+         +------------+
+       |
+       v
+(To: Iteration Loop)

package/templates/commands/pp/SynchronizationProtocol.md

@@ -0,0 +1,90 @@
+# 🔄 "Neuro-Link" Synchronization Protocol (神经链路同步协议)
+
+本工作流旨在解决**“代码与图谱脱节”**的问题。
+无论是**新项目初始化**，还是**既有代码的变更**，必须强制同步至 PPDocs MCP，确保 AI 的记忆永远是最新的。
+
+---
+
+### 1.第一阶段：差异嗅探 (Delta Recognition) 📡
+🔹 **核心目标**：识别代码现实与图谱记忆之间的偏差。
+✏️ **动作**：
+*   **扫描代码库**：检测新增文件、修改的函数、重构的类。
+*   **查询图谱**：读取 PPDocs 当前状态。
+*   **计算差异**：生成 `Diff Report` (例如：代码有 Function A，图谱里没有)。
+× **禁区**：
+*   禁止忽略任何细微的逻辑变更。
+*   禁止在未对比图谱的情况下盲目写入。
+
+### 2.第二阶段：语义映射 (Semantic Mapping) 🧠
+🔹 **核心目标**：将冰冷的代码翻译为可视化的知识节点。
+✏️ **动作**：
+*   **逻辑提取**：AI 阅读代码，提炼核心业务逻辑（非逐行翻译，而是意译）。
+*   **节点定义**：将逻辑转换为 PPDocs 的 `Node` (节点) 和 `Document` (文档) 格式。
+*   **关系构建**：确定新节点与旧节点之间的连线 (Edge/Relationship)。
+× **禁区**：
+*   禁止生成无意义的节点（如 "Variable X changed"）。
+*   必须通过节点连线体现代码的模块化关系。
+
+### 3.第三阶段：图谱注入 (Graph Injection) 💉
+🔹 **核心目标**：调用 MCP 接口，实施持久化存储。
+✏️ **动作**：
+*   **PPDocs 调用**：使用 MCP 工具执行增删改操作 (CRUD)。
+    *   `Create_Node`: 新增模块。
+    *   `Update_Link`: 变更逻辑依赖。
+    *   `Delete_Node`: 清除废弃代码的幽灵节点。
+*   **原子化提交**：确保每次同步都是完整的，不会留下“断头”节点。
+× **禁区**：
+*   禁止手动修改数据，必须通过 MCP 工具。
+*   禁止产生孤立节点 (Orphan Nodes)。
+
+### 4.第四阶段：记忆回溯验证 (Memory Re-check) 🛡️
+🔹 **核心目标**：确保 AI 真的“记住”了。
+✏️ **动作**：
+*   **反向查询**：向 PPDocs 提问刚才更新的逻辑。
+*   **一致性校验**：如果 PPDocs 的回答与代码逻辑一致，标记为 ✅ Synced。
+*   **可视化确认**：输出 ASCII 或 Mermaid 结构图供人类确认。
+
+---
+
+### 📊 同步逻辑可视化图解 (ASCII)
+
+```text
+       +-------------------------+
+       |  💻 代码变更 / 新项目启动 |
+       +-----------+-------------+
+                   |
+                   v
+       +-----------+-------------+
+       |  📡 差异嗅探 (Sniffer)   | <---- PPDocs Current State
+       +-----------+-------------+
+                   |
+                   v
+           /-------+-------\
+          /   存在偏差?     \
+         v                   v
+   (🚫 NO: 结束)         (❗ YES: 需要同步)
+                           |
+                           v
+                 +---------+---------+
+                 |  🧠 语义映射分析   |
+                 | (Code -> Knowledge)|
+                 +---------+---------+
+                           |
+                           v
+                 +---------+---------+
+                 |  💉 PPDocs 注入    |
+                 | (Call MCP Tools)  |
+                 +---------+---------+
+                           |
+                           v
+                 +---------+---------+
+                 |  🛡️ 记忆回溯验证   |
+                 +---------+---------+
+                           |
+               /-----------+----------\
+              /    AI能否准确复述?     \
+             v                          v
+     +-------+-------+          +-------+-------+
+     | ✅ 同步完成    |          | ❌ 失败重试    |
+     | (Persistent)  |          | (Retry Loop)  |
+     +---------------+          +---------------+

package/templates/commands/pp/Zero_Defec_Genesis.md

@@ -0,0 +1,62 @@
+# 🛡️ "Zero-Defect Genesis" Protocol (零缺陷创生协议)
+
+这是一个严格的**“设计-审查-迭代”**自动化流程。只有通过所有安全检查的方案，才会最终呈现给您。
+
+---
+
+### 1.第一阶段：启动设计 (Design) 💡
+*   **动作**：接收任务目标。
+*   **执行**：生成初步的逻辑架构与执行步骤。
+*   **目标**：先有一个可行草稿。
+
+### 2.第二阶段：深度审查 (The Audit) 🧐
+在此阶段，方案必须经过**三道关卡**的严苛检查：
+1.  🎯 **预期核对**：方案能否 100% 达成既定目标？
+2.  🧩 **模块化检查**：结构是否清晰？是否像积木一样解耦，便于维护？
+3.  🛡️ **无害化验证**：是否引入了新的 Bug 或副作用？
+
+### 3.第三阶段：循环验证 (The Loop) 🔄
+*   ❌ **如果验证失败 (Fail)**：
+    *   触发**自动修复机制**。
+    *   针对审查出的问题进行修改。
+    *   **回退**至第二阶段重新审查。
+*   ✅ **如果验证通过 (Pass)**：
+    *   锁定当前版本，进入交付通道。
+
+### 4.第四阶段：最终交付 (Final Output) 🎉
+*   **输出**：经得起推敲的、模块化的、无错的最终方案。
+*   **动作**：展示给您进行最终确认。
+
+---
+
+### 📊 流程可视化图解 (ASCII)
+
+```text
+       +----------------------------+
+       |  💡 START: 初步方案设计     |
+       +-------------+--------------+
+                     |
+                     v
+       +-------------+--------------+
+       |    🧐  深度审查机制         |
+       |----------------------------|
+       |  1. 🎯 预期核对 (Target)   |
+       |  2. 🧩 结构检查 (Modular)  |
+       |  3. 🛡️ 风险排除 (Safety)   |
+       +-------------+--------------+
+                     |
+                     v
+             /-------+-------\
+            /    验证结论?    \
+           /-------------------\
+          /                     \
+    (❌ 失败: FAIL)         (✅ 通过: PASS)
+         |                         |
+         v                         v
+ +-------+-------+         +-------+-------+
+ | 🛠️ 迭代修复   |         | 🎉 最终交付   |
+ | (Auto-Fix)    |         | (Final Output)|
+ +-------+-------+         +---------------+
+         |
+         | (🔄 Return to Audit)
+         +-------------------------^