SuperAPI AI 工具集

cs-resync-codebase

编程与开发

查看项目

更新于 10-15 19:51

技能介绍

用途:功能建成后往往与最初计划不一致。该技能对照当前代码检查 CodeSpring,把功能地图、笔记和 PRD 重新对齐。护栏:对代码库只读,只读取代码与 git 历史,仅写入 CodeSpring(功能、笔记、PRD),绝不修改应用代码。

主要能力与流程: 0. 先连接:执行 codespring auth status 与 codespring status(LOCAL 项目并打印)。

  1. 确定变更:读取 git log、自上次同步点(或用户指定的分支/标签)以来的 git diff 及相关文件当前状态;若设置了 GitHub 远程,以思维导图的 githubUrl 与仓库为参照。聚焦用户构建的功能,同时扫描新路由、表、任务、环境变量与共享系统。
  2. 代码与 CodeSpring 对比:逐项检查受影响功能——代码中新增能力是否已体现为功能/子功能、已记录的是否已不存在;笔记是否仍描述真实流程、文件与路由;前后端 PRD 是否仍匹配,尤其是共享后端契约(路由、数据模型、认证/RLS、任务/cron、存储/桶、支付/积分、环境变量)与依赖图;技术栈是否有新依赖或服务需补充。
  3. 先报告:以“最新/小幅调整/过时”总结,列出具体差异(含文件/路由/表引用与严重程度),大规模重写前先让用户确认。
  4. 更新 CodeSpring(写入此处而非代码):用 codespring feature create --parent ...、feature update ... 增改功能与子功能,保持节点功能计数正确(若被扁平化需重新挂父级);用 codespring mindmap note ... 刷新笔记;PRD 明显过时时用 cs-create-prd 重新生成,或用 codespring prd sync <id> --file 做定向更新;必要时更新技术栈/项目信息。
  5. 确认:列出 CodeSpring 中已更新内容并给出项目链接,说明有意保留的内容(如已计划但未构建的任务)。

适用场景:功能开发完成后的文档回同步、代码与 PRD 漂移检查。限制:仅写入 CodeSpring,不修改代码;具体命令参数与依赖的 codespring 技能引用(analyze-codebase.md、mindmap-structure.md、prd-management.md、pitfalls.md)细节暂未提供。