@haaaiawd/anws 2.2.6 → 2.4.0

package/templates/.agents/skills/output-contract/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: output-contract
+description: 当在本模板 bundle 内需持久化报告、并行子会话、或与多工作流产出对齐时使用。收录共用落盘 spec 与委派闭环；与 craft-authoring（/craft 撰写脚手架）无关。
+---
+
+# 输出契约与协作闭环
+
+> 各 Skill、Workflow 若重复本节条文，应改为**一句引用本 Skill**，仅保留角色或步骤专属增量。
+
+## 何时加载
+
+- 撰写即将写入仓库的架构 / 审查 / 探索类 Markdown。
+- 父会话拆分并行子任务，或按路径切片协作修改。
+- 需要核对「是否可追溯、是否重复叙事、是否单写者」时。
+
+## Spec / 落盘契约
+
+- **Precise**：可核对陈述须带来源或 `path:line` / 章节锚点；禁止无源强结论。
+- **Evidence-backed**：发现 / 证据 / 建议须能指回具体输入或检索结果。
+- **Non-repetitive**：同一事实只写一次；禁止总述与正文两套复述。
+- **No filler**：禁止无主语的「需优化 / 应关注」类空话。
+
+规范块（CRITICAL、严重度表、门禁、上下游契约）**不得删**；收紧仅针对执行旁白与重复叙事。
+
+## 委派闭环（父子会话）
+
+1. **父会话**：`TARGET_DIR`、轮次、最终路径、合并顺序、对规范化报告路径的**唯一写盘**。
+2. **子会话**：有界切片；证据规则与父级相同。
+3. **交接**：子代理返回可合并表结构 + 一行裁定；父代理去重、对照 spec、写 `07_*` / explore 报告，再跑工作流文末 **completion**。
+
+无委派时：单会话跑全文；父级仍负最终落盘与一致性。
+
+## 并行与路径
+
+- 每个被管理路径（或 glob）**每批最多一个写者**；禁止在授权外全仓格式化。
+- 子任务目录或主题须 **不相交**；冲突由父代理裁决。
+- 与 `/genesis` 协同时的检查清单与交接句式见 **`genesis.md`**「子代理编排与检查清单」（或 EN 树同名小节）。

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

@@ -1,92 +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**: 依赖你的风险清单来设计规避策略。
+
+你的分析质量**直接决定**下一阶段的设计质量。