用途:维护并改进 project-scaffolding 技能,分两条互不混淆的路径。路径A“事实刷新”只更新 assets/versions.json 中的版本号,来源为 npm / PyPI 注册表,写错会导致生成项目锁定不存在的版本;路径B“流程改进”改 SKILL.md、references、wizard 选项和 scaffold.py 模板,来源为 assets/observations.md,写错会导致向导推荐错误或生成坏代码。
绝对规则:版本号绝不凭记忆写,必须由 refresh_versions.py 查询注册表;网络不可用时应停止并说明。不得自动应用主版本升级(可能使 scaffold.py 模板源码失效),需先看 references/template-drift.md。任何改动后必须运行验证:scripts/verify_scaffold.py 通过才能重新打包,--install 通过才能采纳版本变更。不得删除观察条目,应就地标记为已解决以保持可审计。
路径A用法:在 project-scaffolding/ 目录运行 python3 scripts/scaffold.py --version-status 查看陈旧程度,python3 scripts/refresh_versions.py 做 dry run,报告分 "-> bump"(主版本内的次要/补丁更新,安全)与 "!! review"(主版本升级、pre-1.0 次要或 0.0.x 补丁,需判断)。带 [safe now: X] 的可由 --apply 自动应用;应用后必须跑 --install。不想要的主版本升级可在 manifest 的 hold 映射中记录理由,如 react-native 需匹配 Expo SDK。
路径B用法:读 assets/observations.md,按标签分组处理:default-rejected 考虑改 SKILL.md 与 wizard-options.md 中的推荐;missing-option 新增框架或选项;broken-output 修生成器并加入 verify_scaffold.py 防回归;template-drift 更新模板方法以匹配锁定的主版本。改变默认值需有模式证据(两三条独立同形条目),单次拒绝不算依据,并注明证据数量。处理后在条目行追加 -> RESOLVED 日期 或 -> WONTFIX 日期 及原因。
验证:--snapshot 记录基线,--compare 与基线比对(重构后应无差异),--install 能发现真实缺陷(如引用未声明包、lint 指向已删命令、tsconfig 选项弃用),需在 manifest 目标 Node 主版本上运行。打包:在仓库根目录执行 zip 命令,注意 assets/ 必须包含,否则导入时报缺少 manifest;随后在 CHANGELOG.md 记录变更。
限制:资料未提供具体依赖版本、支持的项目类型清单、运行环境最低要求及许可信息。