该技能用于在功能构建完成后,将 CodeSpring 与实际代码库重新对齐,使 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 项目;并打印结果)。
第 1 步:确定变更内容 读取近期变更:git log、自上次同步点(或用户指定的分支/标签)以来的 git diff,以及相关文件的当前状态。若设置了 GitHub 远程仓库,则以思维导图的 githubUrl 和该仓库为参照。重点关注用户构建的功能,但也要扫描任意位置新增的路由、表、任务、环境变量和共享系统。
第 2 步:对比代码与 CodeSpring 针对每个受影响的功能,将现实与文档记录进行比对。功能/子功能方面:代码中是否有未体现为功能/子功能的新能力?是否有已记录但不再存在的功能?笔记方面:“how it works”笔记是否仍描述真实的流程、文件和路由?PRD 方面:前端/后端 PRD 是否仍然匹配,尤其是共享的后端契约(路由、数据模型、认证/RLS、任务/cron、存储/桶、支付/积分、环境变量)以及依赖关系图?技术栈方面:是否有需要新增的依赖或服务?
第 3 步:先报告 以“最新 / 小调整 / 过时”进行总结,并附上具体差异的简短列表(每项包含文件/路由/表引用及严重程度)。在进行大规模重写前,先让用户确认。
第 4 步:更新 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 维护项目地图、笔记与 PRD,且在功能构建或代码变更后需要让文档重新与代码对齐的开发工作流。
限制 该技能对代码库只读,不修改应用代码,写入仅限 CodeSpring 内的功能、笔记与 PRD。具体支持的项目类型、认证方式及命令细节暂未提供。