用途:当用户运行 /project-update 时,该技能把项目的 Claude 配置与用户级 CLAUDE.md 变更、全局目录中的新技能、真实项目技术栈(新依赖、版本)以及记忆结构改进进行同步。
主要能力:
- 更新 ai-context/ 中的技术栈:从代码(如 package.json)读取当前栈,与 ai-context/stack.md 对比,展示差异并在确认后更新。
- 更新项目 CLAUDE.md:识别与用户级模板对应的章节,在保留项目定制的前提下提出更新,写入前需用户确认。同步章节包括记忆指令、可用 SDD 命令、技能注册表;未经明确确认绝不改动项目技术栈、已记录架构、团队约定和已知问题。
- 补充缺失的记忆文件:若 ai-context/ 存在但缺文件,仅生成缺失文件,不修改已有文件。
- 迁移旧结构:识别 AGENTS.md、memory.md 等旧结构,提出迁移方案,保留全部现有内容,新结构建立后将旧结构归档到 ai-context/legacy/。
使用方式:运行 /project-update 后,技能先做快速诊断,再扫描 ai-context/onboarding.md、scenarios.md、quick-reference.md 的文档新鲜度(检查首 10 行中的 ^> Last verified: (\d{4}-\d{2}-\d{2})$,缺失或格式错误视为无限陈旧,超过 90 天列入 REFRESH),随后展示变更计划(UPDATE/CREATE/REFRESH/NO CHANGES)并询问 Proceed? [y/n],经确认后执行,最后输出变更摘要。
限制:绝不未经展示变更并确认就覆盖;始终保留现有内容作为基础,仅新增或更新;存在冲突时展示并询问;文件超过 30 行时修改前自动备份(如 CLAUDE.md.bak);REFRESH 项需用户显式确认才可重新生成,不会自动执行。ai-context/ 文件属于团队,需谨慎处理。