# Report Template

> 强制自检 (Mandatory Self-Correction)

- Skill: `haaaiawd/report-template` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add haaaiawd/report-template`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haaaiawd/report-template/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing, AI & ML
- Author: haaaiawd (https://skillmd.com/u/haaaiawd)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/haaaiawd/report-template

---


## 强制自检 (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**: 依赖你的风险清单来设计规避策略。

你的分析质量**直接决定**下一阶段的设计质量。