القائمة
读取 Echoe 的 ADR 知识库（`arch.adr/references`）作为架构 Source of Truth，用于技术方案设计、PRD 对齐、架构评审与 Guardrails 检查。只要用户提到“按 ADR 出方案/按 ADR 对齐 PRD/查架构约束/避免架构漂移”，都应立即启用。`。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
先查验代码再创建 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 | arch-adr |
| description | 读取 Echoe 的 ADR 知识库（`arch.adr/references`）作为架构 Source of Truth，用于技术方案设计、PRD 对齐、架构评审与 Guardrails 检查。只要用户提到“按 ADR 出方案/按 ADR 对齐 PRD/查架构约束/避免架构漂移”，都应立即启用。`。 |
init.adr：初始化 ADR 知识库（存量扫描）maintain.adr：维护与更新 ADR（可写）check.adr：校验 ADR 质量（只读检查）禁止在本技能中改写 ADR 文件。
ADR 的权威来源是：
.claude/skills/arch.adr/SKILL.md（本文件）.claude/skills/arch.adr/references/*.md若发现索引与正文不一致，应提示切换到 maintain-adr 执行修复。
识别当前任务属于：
先读索引表，再按主题读取对应 references/*.md。
从 ADR 提炼：
默认输出结构：
| ADR ID | 类型 | 标题 | 状态 | 文件 |
|---|---|---|---|---|
| ARCH-0001 | ARCH | Constraint Plane 与 Source of Truth | Accepted | references/ARCH-0001-constraint-plane-source-of-truth.md |
| ENG-0001 | ENG | 工程 Guardrails 基线 | Accepted | references/ENG-0001-engineering-guardrails-baseline.md |
| ENG-0002 | ENG | 数据库与存储约束 | Accepted | references/ENG-0002-database-storage-constraints.md |
| ENG-0003 | ENG | 认证与安全约束 | Accepted | references/ENG-0003-auth-security-constraints.md |
| ENG-0004 | ENG | 前端架构约束 | Accepted | references/ENG-0004-frontend-architecture-constraints.md |
| ENG-0005 | ENG | 后端架构约束 | Accepted | references/ENG-0005-backend-architecture-constraints.md |
| ENG-0006 | ENG | APKG 导入架构：浏览器解析 + 服务端导入 | Accepted | references/ENG-0006-apkg-import-architecture.md |
| ENG-0007 | ENG | 导入错误处理策略：优雅降级 | Accepted | references/ENG-0007-import-error-handling.md |
| BIZ-0001 | BIZ | 媒体存储：private bucket + storageKey + 动态访问 | Accepted | references/BIZ-0001-media-storage-private-access.md |
| BIZ-0002 | BIZ | 卡片字段模型：richTextFields 与 Anki 兼容链路 | Accepted | references/BIZ-0002-card-richtext-anki-compat.md |
| BIZ-0003 | BIZ | AI 模型调用链：LLMService 与用户模型配置 | Accepted | references/BIZ-0003-llm-user-model-call-chain.md |
| BIZ-0004 | BIZ | 媒体文件导入处理策略 | Accepted | references/BIZ-0004-media-import-strategy.md |