Docs from code

Skill BackToCimaCoppi/Praxis/skills/docs-from-code

给「AI 驱动开发」立规矩的 Claude Code skill 方法论库：七层文档治理 · 对抗评审 · 任务总控三驾马车，外加老代码考古、施工蓝图等共 16 个 skill —— 让 AI 写代码又快又不失控。

Install

npx -y skills add BackToCimaCoppi/Praxis --skill docs-from-code

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

从代码反推需求文档（L1 补写）的通用方法论 skill。任何项目里需要为已有代码补写需求文档时使用。提供 7 步操作流程、前后端代码阅读重点、归档使用规则、不确定信息处理、需求文档模板。项目特定约定（目录结构、版本制、命名规则）见各项目自身 docs-writing-guide skill。触发词："补写需求文档"、"从代码反推"、"L1 补写"、"反推 L1"。

SKILL.md

2.1 KB, as published. Nobody here has run it

从代码反推需求文档（L1 补写）

项目特定约定（目录结构、版本制、命名规则）优先参考各项目 docs-writing-guide skill。本 skill 只提供通用方法论。

1. 操作流程

补写 <项目>/docs/01-需求/ 时，按以下顺序操作：

1. 确定模块边界
2. 从前端找：页面、入口、交互动作
3. 从后端找：接口、业务能力、规则与状态
4. 从枚举和模型补充：状态、类型、边界条件
5. 查看项目归档目录，只做补充和交叉核对（不能覆盖代码事实）
6. 用业务语言重写成需求文档
7. 最后清理："是否写进了实现细节？"

2. 代码阅读重点

前端

页面名称与层级、tab 与分包结构
服务调用名称、按钮文案
空状态 / 错误状态处理、页面跳转关系

后端

Controller 对外能力
枚举体现的状态和值域
Biz / Service 中的规则与限制
权限校验、状态流转、外部依赖

3. 归档使用规则

可以用归档补充：模块命名、业务意图、代码中不明显的边界规则

不能用归档：覆盖代码事实、把旧方案当成当前事实

4. 不确定信息处理

回到代码继续验证
用归档做交叉核对
仍无法确认 → 写「待确认」，不虚构结论

5. 需求文档推荐模板

每个模块的编号 README（例如 01-xx-00-README.md）或模块说明文档推荐章节：

0. 版本归属 / 适用版本
1. 模块目标
2. 用户价值
3. 页面与入口
4. 功能列表
5. 业务规则
6. 状态流转
7. 系统支撑能力
8. 异常与边界场景
9. 与其他模块的关系
10. 验收标准