Documentation
README
造典关卡 · 文档生成器
生成的是骨架,不是答案。填决策理由是人的工作,工具不能代劳。
何时使用
| 场景 | 跑 | 理由 |
|---|---|---|
| 新模块创建后第一时间 | ✅ | 趁记忆新鲜填决策 |
| verifying-modules 报「缺 README/DESIGN」 | ✅ | 直接补救 |
| 重构后边界变化 | ⚠ | 看是否要重生成或手动改;不要 --force 覆盖已有内容 |
| 已有完整文档 | ❌ | 不要破坏人工写的内容 |
生成内容
README.md(自动可填部分)
| 字段 | 自动来源 | 待人补 |
|---|---|---|
| 模块名 | 目录名 | 是否有更好的展示名 |
| 描述 | 顶级 docstring(Python) | 「存在理由」必须人写 |
| 特性 | TODO(占位) | 列 3–5 个核心能力 |
| 依赖 | requirements.txt / package.json / Cargo.toml 等 |
是否有运行时假设 |
| 使用方法 | TODO(占位) | 5 分钟跑通示例 |
| API 概览 | 公开类/函数签名 | 调用顺序、生命周期 |
| 目录结构 | tree 输出 |
— |
DESIGN.md(骨架占位)
This is the opening of the README. Read the full README on GitHub.