Menu
校验 Echoe 的 ADR 知识库。检查 ADR 质量、一致性和覆盖率，输出校验报告。若待校验 ADR 量很大，必须启用分片、子 Agent 并行和磁盘检查点策略。用户提到"校验 ADR/检查 ADR/ADR 质量检查"时必须启用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
先查验代码再创建 GitHub Issue。只要用户提出“先确认是不是问题再提 issue”“根据代码排查并建单”“把用户反馈转成 issue”这类请求，就必须启用本技能：先验证问题是否成立，证据不足时主动追问用户补充，再用 gh CLI 按模板创建 issue。
用于按优先级串行修复 GitHub issue 的技能。只要用户提到“修 issue / 批量修 bug / 从 P0 开始处理 / 逐个修复问题 / 自动修复 issue 队列”等，都应启用。必须先复用 `gh.issue` 技能获取 issue，上游按 P0->P1->P2->P3->P4 排序，每次只处理一个 issue，并且每个 issue 都用子 Agent 修复；默认自动连续处理，只有遇到功能语义或产品策略需要产品经理确认时才暂停并向用户确认。每个成功修复的 issue 都必须由子 Agent 完成 commit（commit 信息关联 issue）并自动评论“已修复”后关闭。
Practical Anki v11 schema and import/export compatibility guide for Echoe. Use this skill whenever the user mentions Anki, .apkg/.anki2, notes/cards/revlog tables, notetype/deck JSON blobs, or fields like flds/sfld/csum/guid/usn/due. Even if the request sounds generic (for example "flashcard import" or "Anki sync issue"), consult this skill first before implementing or reviewing code.
面向 React + TypeScript 项目的代码坏味道审查 Skill。当用户提到 code review、clean code、技术债、可维护性、重构建议、组件太复杂、组件拆分过细、Hook 混乱、类型设计问题、PR 审查，或 @rabjs/react 领域模式与状态传递问题时，必须优先使用本 Skill。发现可执行问题时，必须使用 `gh` CLI 创建 GitHub issue。
审查需求文档（PRD/需求说明/业务规则）是否足够清晰、无歧义并可用于生成技术方案。Whenever user asks "帮我看需求是否清楚"、"这个需求能不能直接出技术方案"、"找出模糊定义/规则歧义/功能不清晰"，都应主动使用本技能，即使用户只提供需求片段或会议纪要。
Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out.
| name | check-adr |
| description | 校验 Echoe 的 ADR 知识库。检查 ADR 质量、一致性和覆盖率，输出校验报告。若待校验 ADR 量很大，必须启用分片、子 Agent 并行和磁盘检查点策略。用户提到"校验 ADR/检查 ADR/ADR 质量检查"时必须启用。 |
maintain-adr 的职责）当待校验 ADR 数量过大时，必须采用“全量基础校验 + 分层深度校验 + 磁盘检查点”策略，避免上下文压缩导致结果丢失。
L1（<= 80）：全量深度校验L2（81 ~ 300）：分片并行校验（建议每片 30~50）L3（> 300）：两阶段校验（全量基础校验 + 风险优先深度校验）优先深度校验以下 ADR：
Proposed / Superseded / DeprecatedERR-* 或 WARN-*低风险 ADR 至少抽样 20% 做深度校验，避免漏检。
检查每个 ADR 是否包含必需字段：
检查 Evidence 中的路径是否真实存在：
检查 ADR 状态与索引是否一致：
Superseded 状态的 ADR 是否有对应的替代 ADRDeprecated 状态的 ADR 是否有废弃说明检查 ADR-ID 是否符合规范：
检查 ADR 内容质量：
检查仓库关键领域是否有 ADR 覆盖：
run_id（示例：2026-03-17T17-00-00Z）.claude/skills/check.adr/workspace/<run_id>/manifest.json（分片状态：pending/running/done/failed）inventory.json（待校验 ADR 清单）chunks/（每个分片的校验输出）report/（聚合报告）.claude/skills/arch.adr/SKILL.md 索引references/ 下所有 ADR 文件inventory.jsonmanifest.json每个分片启动子 Agent，必须先写磁盘再返回摘要：
.claude/skills/check.adr/workspace/<run_id>/chunks/<chunk-id>/baseline.json子 Agent 仅返回摘要（通过数/失败数/输出文件路径），禁止在对话粘贴全量细节。
.claude/skills/check.adr/workspace/<run_id>/chunks/<chunk-id>/deep.json深度校验项包括：
.claude/skills/check.adr/workspace/<run_id>/report/coverage.json聚合 baseline.json + deep.json + coverage.json，生成：
.claude/skills/check.adr/workspace/<run_id>/report/final-report.md
并输出结构化报告：
# ADR 校验报告
## 概览
- run_id：<run_id>
- 校验模式：L1 / L2 / L3
- 总 ADR 数量：X
- 基础校验通过：Y
- 深度校验通过：Z
- 错误项：E
- 警告项：W
## 错误项（必须修复）
| ADR-ID | 问题类型 | 问题描述 | 修复建议 |
| -------- | -------- | ------------- | ------------ |
| ENG-0001 | 缺失字段 | 缺少 Evidence | 补充代码路径 |
## 警告项（建议修复）
| ADR-ID | 问题类型 | 问题描述 | 修复建议 |
| -------- | -------- | ----------- | -------- |
| BIZ-0002 | 文件过长 | 超过 660 行 | 考虑拆分 |
## 覆盖率分析
| 领域 | 状态 | 备注 |
| -------- | ----------- | --------------------- |
| 认证授权 | ✅ 已覆盖 | ARCH-0001 |
| 数据存储 | ⚠️ 部分覆盖 | 缺少 LanceDB 迁移规范 |
| 错误处理 | ❌ 未覆盖 | 建议新增 |
## 分片执行情况
| 分片 | 状态 | ADR 数量 | 失败数 |
| ---- | ---- | -------- | ------ |
| chunk-001 | ✅ done | 40 | 1 |
| chunk-002 | ✅ done | 40 | 0 |
## 建议操作
1. [优先] 修复 ERR 级问题
2. [建议] 对未深度覆盖 ADR 做下一轮补检
3. [可选] 补齐缺失领域 ADR
默认在报告产出后删除：
.claude/skills/check.adr/workspace/<run_id>/
例外：若存在失败分片，允许保留该 run_id 用于断点续跑；续跑完成后必须删除。
| 规则 ID | 规则描述 |
|---|---|
ERR-001 | 缺少必需字段 |
ERR-002 | Evidence 路径不存在 |
ERR-003 | Status 与索引不一致 |
ERR-004 | Supersede 关系断裂 |
ERR-005 | ADR-ID 重复 |
| 规则 ID | 规则描述 |
|---|---|
WARN-001 | 文件超过 660 行 |
WARN-002 | Evidence 证据不充分 |
WARN-003 | Constraint 表述模糊 |
WARN-004 | 缺少 Guardrails 检查项 |
WARN-005 | Change Log 不完整 |
| 规则 ID | 规则描述 |
|---|---|
INFO-001 | 标题可更简洁 |
INFO-002 | Context 可补充更多背景 |
INFO-003 | Impact 可补充业务影响 |
maintain-adr 修复