@haaaiawd/anws 2.2.2 → 2.2.3

package/templates/.agents/skills/report-template/SKILL.md

@@ -1,85 +1,92 @@
----
-name: report-template
-description: 综合 Probe 阶段所有分析（nexus-mapper, runtime-inspector），生成决策就绪的系统风险报告。
----
-
-# 综合者手册 (The Synthesizer's Manual)
-
-> "数据不是信息。信息不是知识。知识不是智慧。" —— T.S. Eliot
-
-你的目标是将原始分析数据转化为**架构师可用的智慧**。
-
----
-
-## ⚠️ 强制自检 (Mandatory Self-Correction)
-
-> [!IMPORTANT]
-> 在生成报告之前，你**必须**进行自我检查：
-> 1.  "nexus-mapper 发现的构建边界和 runtime-inspector 发现的 IPC 边界是否一致？"
-> 2.  "nexus-mapper 发现的高耦合文件对是否跨越了构建边界？"
-> 3.  "nexus-mapper 识别的缺失组件是否与已发现的风险相关？"
-> 4.  "这份报告是否足够完整？"
-
----
-
-## ⚡ Quick Start
-
-1.  **读取模板 (MANDATORY)**: 读取 `references/REPORT_TEMPLATE.md`。你的报告**必须**完全匹配此结构。
-2.  **综合所有发现**: 汇总来自以下来源的输出：
-    *   `nexus-mapper` → Build Roots, Topology, Coupling Pairs, Hotspots, Entities, Missing Components
-    *   `runtime-inspector` → IPC Surfaces, Contract Status
-3.  **起草报告**: 按照模板组织逻辑连接。
-4.  **发布 (CRITICAL)**: 你**必须**创建 `.anws/v{N}/00_PROBE_REPORT.md` 并写入完整报告。**禁止**仅打印到聊天。确保 `.anws/v{N}/` 目录存在。
-
----
-
-## ✅ 完成检查清单
-
-在进入下一阶段之前，验证：
-- [ ] 输出文件已创建: `.anws/v{N}/00_PROBE_REPORT.md`
-- [ ] 包含: System Fingerprint, Component Map, Risk Matrix, Feature Landing Guide
-- [ ] 用户已确认发现
-
----
-
-## 🛠️ 综合仪式
-
-### 1. 执行摘要 (Executive Summary)
-*   **电梯演讲**: 用 30 秒描述系统的健康状况。
-*   **聚焦点**: 技术债务、关键风险、可靠性。
-
-### 2. 暗物质检测
-*   不仅仅列出存在的东西。**列出缺失的东西**。
-*   检查清单: 日志？错误处理？CI/CD？密钥管理？版本握手？
-
-### 3. 交叉验证 (Cross-Verification)
-*   **nexus-mapper** 说 "Workspace 统一管理"？
-*   **nexus-mapper** 说 "高耦合跨越构建根"？
-*   **结论**: 发现隐藏逻辑耦合 → **重构目标**。
-
-### 4. 人工检查点
-*   强制用户确认: "这份报告完整吗？"
-*   **在此报告签字前，禁止进入 Blueprint 阶段**。
-
----
-
-## 🛡️ 老师傅守则
-
-1.  **禁止幻觉**: 每个声明必须链接到源文件。
-2.  **残酷诚实**: 直言不讳。如果是一团糟，就说是一团糟。
-3.  **行动导向**: 列出的每个问题都必须暗示一个解决方案 (重构/重写/保留)。
-
----
-
-## 🧰 工具箱
-
-*   `references/REPORT_TEMPLATE.md`: 报告主模板。
-
----
-
-## Consumers (消费者)
-
-这份报告的直接消费者是 `/blueprint` 阶段的:
-*   **System Architect**: 依赖你的风险清单来设计规避策略。
-
-你的分析质量**直接决定**下一阶段的设计质量。
+---
+
+## name: report-template
+description: 综合 Probe 阶段所有分析（nexus-mapper, runtime-inspector），生成决策就绪的系统风险报告。
+
+# 综合者手册 (The Synthesizer's Manual)
+
+> "数据不是信息。信息不是知识。知识不是智慧。" —— T.S. Eliot
+
+你的目标是将原始分析数据转化为**架构师可用的智慧**。
+
+---
+
+## 强制自检 (Mandatory Self-Correction)
+
+> [!IMPORTANT]
+> 在生成报告之前，你**必须**进行自我检查：
+>
+> 1. "nexus-mapper 发现的构建边界和 runtime-inspector 发现的 IPC 边界是否一致？"
+> 2. "nexus-mapper 发现的高耦合文件对是否跨越了构建边界？"
+> 3. "nexus-mapper 识别的缺失组件是否与已发现的风险相关？"
+> 4. "这份报告是否足够完整？"
+
+---
+
+## Quick Start
+
+1. **读取模板 (MANDATORY)**: 读取 `references/REPORT_TEMPLATE.md`。你的报告**必须**完全匹配此结构。
+2. **综合所有发现**: 汇总来自以下来源的输出：
+  - `nexus-mapper` → Build Roots, Topology, Coupling Pairs, Hotspots, Entities, Missing Components
+  - `runtime-inspector` → IPC Surfaces, Contract Status
+3. **起草报告**: 按照模板组织逻辑连接。
+4. **发布 (CRITICAL)**: 你**必须**创建 `.anws/v{N}/00_PROBE_REPORT.md` 并写入完整报告。**禁止**仅打印到聊天。确保 `.anws/v{N}/` 目录存在。
+
+---
+
+## 完成检查清单
+
+在进入下一阶段之前，验证：
+
+- 输出文件已创建: `.anws/v{N}/00_PROBE_REPORT.md`
+- 包含: System Fingerprint, Component Map, Risk Matrix, Feature Landing Guide
+- 用户已确认发现
+
+---
+
+## 综合仪式
+
+### 1. 执行摘要 (Executive Summary)
+
+- **电梯演讲**: 用 30 秒描述系统的健康状况。
+- **聚焦点**: 技术债务、关键风险、可靠性。
+
+### 2. 暗物质检测
+
+- 不仅仅列出存在的东西。**列出缺失的东西**。
+- 检查清单: 日志？错误处理？CI/CD？密钥管理？版本握手？
+
+### 3. 交叉验证 (Cross-Verification)
+
+- **nexus-mapper** 说 "Workspace 统一管理"？
+- **nexus-mapper** 说 "高耦合跨越构建根"？
+- **结论**: 发现隐藏逻辑耦合 → **重构目标**。
+
+### 4. 人工检查点
+
+- 强制用户确认: "这份报告完整吗？"
+- **在此报告签字前，禁止进入 Blueprint 阶段**。
+
+---
+
+## 老师傅守则
+
+1. **禁止幻觉**: 每个声明必须链接到源文件。
+2. **残酷诚实**: 直言不讳。如果是一团糟，就说是一团糟。
+3. **行动导向**: 列出的每个问题都必须暗示一个解决方案 (重构/重写/保留)。
+
+---
+
+## 工具箱
+
+- `references/REPORT_TEMPLATE.md`: 报告主模板。
+
+---
+
+## Consumers (消费者)
+
+这份报告的直接消费者是 `/blueprint` 阶段的:
+
+- **System Architect**: 依赖你的风险清单来设计规避策略。
+
+你的分析质量**直接决定**下一阶段的设计质量。

package/templates/.agents/skills/runtime-inspector/SKILL.md

@@ -13,7 +13,7 @@ description: 分析运行时行为、进程边界和 IPC 机制，检测"协议
 
 ---
 
-## ⚠️ 深度思考要求
+## 深度思考要求
 
 > [!IMPORTANT]
 > **运行时分析需要深度思考，思考方式基于模型能力和任务复杂度。**
@@ -30,12 +30,12 @@ description: 分析运行时行为、进程边界和 IPC 机制，检测"协议
 
 ---
 
-## ⚡ 任务目标
+## 任务目标
 识别**运行时边界 (Runtime Boundaries)** 和 **通信契约 (Communication Contracts)**。
 
 ---
 
-## 🧭 探索流程 (The Investigation)
+## 探索流程 (The Investigation)
 
 ### 第一步：识别入口点 (Identify Entry Points)
 每个 `main` 函数可能代表一个独立的进程。
@@ -53,8 +53,8 @@ description: 分析运行时行为、进程边界和 IPC 机制，检测"协议
     *   Python: `subprocess.Popen`, `multiprocessing.Process`
     *   Node: `child_process.spawn`, `child_process.fork`
 *   **老师傅警报 (Lifecycle Risks)**:
-    *   ⚠️ "父进程死了，子进程知道吗？有心跳吗？" -> **僵尸进程风险 (Zombie Child)**
-    *   ⚠️ "子进程崩溃了，父进程会重启它吗？还是静默失败？" -> **静默故障风险**
+    *    "父进程死了，子进程知道吗？有心跳吗？" -> **僵尸进程风险 (Zombie Child)**
+    *    "子进程崩溃了，父进程会重启它吗？还是静默失败？" -> **静默故障风险**
 
 ### 第三步：窃听通信 (Tap the Wire)
 进程之间用什么"说话"？协议在哪里定义？
@@ -70,26 +70,26 @@ description: 分析运行时行为、进程边界和 IPC 机制，检测"协议
 
     | 发现 | 状态 | 老师傅建议 |
     | :--- | :---: | :--- |
-    | 找到 Channel + 找到 `enum Message` 或 Protobuf 定义 | 🟢 **Strong** | 契约存在，相对安全。 |
-    | 找到 Channel + 找到 `Version` 或 `Handshake` 检查 | 🟢 **Strong** | 有版本协商，很好。 |
-    | 找到 Channel + 只有 raw JSON/字符串 | 🟡 **Weak** | 无显式契约。改动一端可能炸另一端。 |
-    | 找到 Channel + 无任何协议定义 | 🔴 **None** | **通信黑洞！** 这是高危风险。 |
+    | 找到 Channel + 找到 `enum Message` 或 Protobuf 定义 |  **Strong** | 契约存在，相对安全。 |
+    | 找到 Channel + 找到 `Version` 或 `Handshake` 检查 |  **Strong** | 有版本协商，很好。 |
+    | 找到 Channel + 只有 raw JSON/字符串 |  **Weak** | 无显式契约。改动一端可能炸另一端。 |
+    | 找到 Channel + 无任何协议定义 |  **None** | **通信黑洞！** 这是高危风险。 |
 
 ---
 
-## 🛡️ IPC 风险模式速查 (来自安全研究)
+## IPC 风险模式速查 (来自安全研究)
 
 | 风险模式 | 检测特征 | 老师傅建议 |
 | :--- | :--- | :--- |
 | **协议漂移 (Protocol Mismatch)** | Channel 存在，但无 Handshake/Version | 在新功能规划中**强制添加版本握手任务** |
 | **僵尸进程 (Zombie Child)** | `spawn` 存在，但无 `Kill on Drop` 或心跳 | 标记进程生命周期管理风险 |
 | **单点故障 (SPOF)** | 一个进程管控所有 IPC，无容错 | 建议添加重连/重启逻辑 |
-| **Named Pipe 权限漏洞 (Windows)** | 使用 Named Pipe 但未显式设置 Security Descriptor | 🔴 高危：默认可能允许 Everyone 访问！ |
+| **Named Pipe 权限漏洞 (Windows)** | 使用 Named Pipe 但未显式设置 Security Descriptor |  高危：默认可能允许 Everyone 访问！ |
 | **竞态条件 (Race Condition)** | 多进程快速交互，无明确的消息顺序控制 | 建议添加消息序列号或锁机制 |
 
 ---
 
-## 📤 输出清单
+## 输出清单
 
 1.  **Process Roots**: 发现的入口点列表（文件路径、角色）。
 2.  **Spawning Chains**: 进程生成关系 (A spawns B)。