来源笔记
Spine – verified codebase onboarding for Claude Code
摘要
Spine 是一个 CLI 和 Claude Code 技能，用来为不熟悉的代码库生成经过验证的入门指南。它使用静态源码关系生成一张小型架构图、阅读顺序，以及供后续 Claude 会话使用的仓库上下文文件。
问题
- 开发者和编码代理在新仓库里常常会浪费时间找入口点、子系统，以及先读哪些文件。
- 现有的入门文档可能过时、范围太大，或者基于猜测，这会误导人和 Claude Code 会话。
- 这个工具之所以重要，是因为仓库上下文会影响代码审查、修 bug、做功能开发和代理提示。
方法
- Spine 先检测可能的入口点，再从它能通过静态分析验证的源码关系中提取一个小型“spine”。
- 它只根据已验证的边生成 Mermaid 架构图；如果 Mermaid 验证连续失败两次，就不输出这张图。
/map路径提供确定性的仅地图预览，不做综合步骤，也不生成ONBOARDING.md。/onboard路径会写出完整指南，包含已验证的图、阅读顺序、心智模型、子系统摘要、注意事项和预估阅读时间。- 配合
--write-context-file，它可以刷新.claude/REPO_CONTEXT.md，让后续 Claude Code 会话从一份紧凑的仓库快照开始。
结果
- 摘要没有报告受控评估、基准分数、数据集结果或基线对比。
- 一次示例运行检测到
1个 JavaScript 库入口点，写入了ONBOARDING.md，并覆盖了7个 spine 文件和4个子系统。 - 示例成本估算大约是
0.008美元输入加0.010美元输出，总计约0.018美元。 - 示例声称，花费约
0.02美元的 LLM 成本，可节省约3.5小时的人工探索时间。 - 当前已验证的 spine 覆盖列出
6个语言家族：TypeScript/JavaScript、Python、Go、Rust 和 PHP，其中 TypeScript 和 JavaScript 归在一起。 - 启动基准推荐仓库是
axios；摘要里提到的后续演示仓库是glow、poetry和log。