关于 cs-build-resync-codebase
用于核对 CodeSpring 项目记录与当前代码及 Git 历史的技能。它报告差异并更新 CodeSpring 中的内容，同时保持代码库只读。
主要功能
- 01对照代码与 Git 历史检查 CodeSpring
- 02检查功能、说明、PRD 和技术栈
- 03按严重程度及具体引用报告偏差
- 04仅更新 CodeSpring，不修改代码
适用场景
- 01功能实现后同步项目记录
- 02发现过时的路由、数据模型或技术说明
- 03实现变更后更新 PRD
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/cs-build-resync-codebase确认已加载。
详细介绍
让 CodeSpring 与代码库重新同步
功能完成后，通常不会与最初的计划完全一致。此技能会检查 CodeSpring 与当前代码的差异，并让地图/笔记/PRD 与实际情况保持一致。
安全限制：此操作只读代码库。 它会读取代码和 Git 历史记录，并且只会写入 CodeSpring（功能、笔记、PRD）。切勿通过此技能修改应用程序代码。
使用：codespring 技能参考（analyze-codebase.md、mindmap-structure.md、prd-management.md、pitfalls.md）。
0. 首先连接
运行 codespring auth status + codespring status（LOCAL project；打印出来）。
1. 确定发生了哪些变化
- 查看近期变更：
git log、自上次同步点（或用户指定的分支/标签）以来的git diff，以及相关文件的当前状态。如果已设置 GitHub 远程地址，则以思维导图中的githubUrl和代码仓库为准。 - 聚焦用户构建的功能，同时扫描各处是否存在新路由、表、作业、环境变量和共享系统。
2. 对比代码与 CodeSpring
对于每个受影响的功能，对照实际情况与文档：
- 功能/子功能——代码中是否有尚未体现为功能/子功能的新能力？文档中是否有已不存在的功能？
- 笔记——“工作原理”笔记是否仍准确描述实际流程、文件和路由？
- PRD——前端/后端 PRD 是否仍与实际情况一致？尤其是共享后端契约（路由、数据模型、身份验证/RLS、作业/cron、存储/存储桶、付款/积分、环境变量）和依赖关系图。
- 技术栈——是否有需要添加的新依赖项/服务？
3. 先报告
总结为：保持最新 / 有少量调整 / 已过时，并简要列出具体差异（每项都注明文件/路由/表的引用位置和严重程度）。进行大规模重写前，先让用户确认。
4. 更新 CodeSpring（只写入 CodeSpring，不写入代码）
- 添加/调整功能和子功能（
codespring feature create --parent ...、feature update ...），并确保node-features数量正确（如果层级被扁平化，则重新设置父级——参见pitfalls.md）。 - 更新笔记（
codespring mindmap note ...）。 - 更新 PRD：对于内容实质过时的 PRD，使用
cs-build-create-prd重新生成；对于指定内容的更新，使用codespring prd sync <id> --file。 - 如有需要，更新技术栈/项目信息。
5. 确认
列出已在 CodeSpring 中更新的内容，并提供项目链接。注明有意保留的事项（例如计划中但尚未构建的任务）。
什么才算做得好
- CodeSpring 反映代码当前的实际行为，而不只是最初的计划。
- 报告差异时按严重程度分类，并提供精确引用位置；重写前先报告。
- 代码库从未被修改——只更新了 CodeSpring。
评论
支持 Markdown