blader/schematic
GitHub: blader/schematic
一款 Claude Code / Codex 技能插件,通过分析 git 分支的代码变更自动逆向生成结构化的产品与技术规范文档。
Stars: 203 | Forks: 20
# 示意图
一项技能,能够根据 git 分支的具体实现逆向工程出详细的产品和技术规范。
适用场景:
- 某个分支已发布或正在开发中,需要编写文档
- 你需要在产品和架构层面上了解某个分支的功能
- 熟悉他人的功能分支
- 事后补充编写 PR 描述或设计文档
它会生成一份结构化的 markdown 规范,涵盖问题描述、产品需求、架构、技术设计、文件清单、测试策略、发布计划和风险评估。
## 安装
### Claude Code
```
git clone https://github.com/blader/schematic.git ~/.claude/skills/schematic
```
重启 Claude Code 以加载新技能。
### Codex
```
git clone https://github.com/blader/schematic.git ~/.codex/skills/schematic
```
或者使用内置技能安装器:
```
Install the skill from github.com/blader/schematic
```
重启 Codex 以加载新技能。
## 使用方法
在 Claude Code 或 Codex 中,只需输入:
- “逆向工程提取此分支的规范”
- “分析此分支”
- “根据代码编写规范”
- “记录此分支的功能”
该技能将系统地分析分支上修改的每个文件,并生成一份详尽的规范文档。
## 工作原理
1. **确定分支范围** - 获取完整的 diff 统计信息并对文件进行分类
2. **并行深度探索** - 启动 2-4 个并行 agent,并发读取文件组
3. **交叉检查遗漏** - 将已分析的文件与完整文件列表进行 diff 对比,以查漏补缺
4. **编写规范** - 生成一份结构化的 11 部分 markdown 文档
5. **验证完整性** - 确保每一个修改过的文件都被准确记录
## 许可证
MIT
标签:AI编程助手, Claude Code, Git, SOC Prime, 代码分析, 凭证管理, 开发工具, 文档生成, 网络安全研究, 防御加固