用途:扫描工作区,将 docs/project-config.json 更新为与当前项目结构匹配的准确值。适用于需要维护项目配置、初始化或刷新项目文档上下文的场景。
主要能力:按项目规模(小/中/大)分类后分阶段执行;覆盖模块(后端/前端)、项目元数据、框架模式、上下文组、设计系统、样式、组件系统、测试、E2E、数据库、消息、API、基础设施、图连接器、参考文档等配置分节;每阶段执行扫描→合并→校验→抽查→修复循环。
使用方式:先运行 node .claude/hooks/lib/project-config-schema.cjs --describe 读取精确字段名,再按 Plan → Review → Execute 流程执行;每阶段用 validateConfig(config) 校验,路径正则使用 [\/] 匹配跨系统分隔符。specRoots 与 techSpecScan 需从本项目源码推导,annotationPattern 必须恰好两个捕获组(trait 名与 spec id)。
限制:不得重命名、删除或重构顶层分节,不得更改字段类型;不得为旧项目填充已弃用的 v1 分节;缺少 spec 注解约定时不得臆造,应省略 techSpecScan 并填写 _techSpecScanNote。若必需步骤或工具无法在当前环境运行,应停止并询问用户。具体命令、字段与流程以资料为准,其余细节暂未提供。