菜单
从代码反推需求文档（L1 补写）的通用方法论 skill。任何项目里需要为已有代码补写需求文档时使用。提供 7 步操作流程、前后端代码阅读重点、归档使用规则、不确定信息处理、需求文档模板。项目特定约定（目录结构、版本制、命名规则）见各项目自身 docs-writing-guide skill。触发词："补写需求文档"、"从代码反推"、"L1 补写"、"反推 L1"。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
从老旧黑盒代码反推「树形索引、逐层下钻」的知识库（业务逻辑/数据库/接口三层），给重构 AI 注入背景。承诺「边界内可审计覆盖 + 残余风险显式登记」，不承诺零遗漏。触发词：「老代码考古」「反推知识库」「重构前背景」「把老项目翻译成文档」「legacy 调查」。
对抗评审 skill。主线程把待评审内容（设计文档 / 代码 / 任意方案）原样打成证据包，并行起 Claude(Opus) 子线程与 codex(GPT 5.5) 做两份独立评审，再由 Opus 裁判逐条裁决采纳/驳回，产出最终报告。Claude 轮用 Agent 工具，GPT 轮用 codex。触发词："克劳德评审"、"对抗评审"。
Use when the user wants to consult Claude for a second opinion, audit, or direct execution. 触发词："问一下克劳德"、"问一下claude"、"问一下sonnet"、"让克劳德去做"、"让claude直接XX"、"问一下opus"、"让opus去做"。This skill uses the Agent tool to spawn a Claude subagent from the main thread. All synthesis and decisions stay in the main thread.
让 Opus 子线程处理最复杂的分析和执行任务。触发词："问一下opus"、"让opus去做"。主线程（L1）制包，Opus（L3）深度推理。
让 Sonnet 子线程分析或执行任务。触发词："问一下sonnet"、"问一下claude"、"让sonnet去做"、"让claude去做"。主线程（L1）制包，Sonnet（L2）深度推理。
从现有代码冷启动、生成七层文档反推总控文档的 skill（用户级通用）。本 skill 的交付物是「扫描摘要 + 任务总控编排文档」，不包含具体层的文档撰写（Phase 3 由 /control 驱动，单独消耗会话预算）。适用场景：项目无文档或文档严重过时、需要系统性规划七层文档补写任务。触发词：「冷启动建文档骨架」「反推文档体系总控」「从代码反推文档」「代码到七层」「反推文档体系」。
| name | docs-from-code |
| description | 从代码反推需求文档（L1 补写）的通用方法论 skill。任何项目里需要为已有代码补写需求文档时使用。提供 7 步操作流程、前后端代码阅读重点、归档使用规则、不确定信息处理、需求文档模板。项目特定约定（目录结构、版本制、命名规则）见各项目自身 docs-writing-guide skill。触发词："补写需求文档"、"从代码反推"、"L1 补写"、"反推 L1"。 |
项目特定约定（目录结构、版本制、命名规则）优先参考各项目
docs-writing-guideskill。 本 skill 只提供通用方法论。
补写 <项目>/docs/01-需求/ 时，按以下顺序操作：
1. 确定模块边界
2. 从前端找：页面、入口、交互动作
3. 从后端找：接口、业务能力、规则与状态
4. 从枚举和模型补充：状态、类型、边界条件
5. 查看项目归档目录，只做补充和交叉核对（不能覆盖代码事实）
6. 用业务语言重写成需求文档
7. 最后清理："是否写进了实现细节？"
前端
后端
可以用归档补充：模块命名、业务意图、代码中不明显的边界规则
不能用归档：覆盖代码事实、把旧方案当成当前事实
每个模块的编号 README（例如 01-xx-00-README.md）或模块说明文档推荐章节：
0. 版本归属 / 适用版本
1. 模块目标
2. 用户价值
3. 页面与入口
4. 功能列表
5. 业务规则
6. 状态流转
7. 系统支撑能力
8. 异常与边界场景
9. 与其他模块的关系
10. 验收标准