用途:为项目搭建 references/layout-spec.md 定义的 harness 结构;该规范是权威依据,技能文件本身是操作流程。适用于需要初始化或增量修复 AI 协作脚手架的项目。
主要能力(分阶段): Phase 0 前置检查:确认当前目录是 git 仓库根目录(git rev-parse --show-toplevel 等于 cwd);不是则停止并询问是否先 git init。扫描已存在的规范路径,全部记入 SKIPPED 列表且不改动。 Phase 1 检测:从项目文件自动填充占位符,如项目名取 package.json 的 name 否则目录名;包管理器按 bun.lock/bun.lockb、pnpm-lock.yaml、package-lock.json、yarn.lock 判断;测试/类型检查/lint 命令取 package.json scripts,缺失则标 TODO(verify);Git 主机与 MR 工具按 git remote get-url origin 判断;基础分支优先 develop 再 main。 Phase 2 提问:只问检测未解决的占位符,且一次一问并附推荐默认;提交 emoji 位置(type 前或后)与 worktree 约定(仓库内 .worktrees/ 或同级目录)必须询问,不可猜测;若仓库有 commitlint 配置应先读取以覆盖 emoji 答案。 Phase 3 搭建:按 templates/ 逐文件去掉 .tmpl 后缀、替换占位符并写入相同相对路径;已存在文件跳过;无法解析的占位符保留为字面 TODO(verify) 行,绝不编造。仓库内 worktree 约定时确保 .worktrees/ 写入 .gitignore,并在测试运行器文件匹配中排除(不清楚则记为 NEXT STEP)。kb/ 不归本技能所有,缺失时添加 NEXT STEP 运行 npx skills add RayChang/agent-skills@kb-wiki,存在则记为跳过。无对应模板的规范路径不搭建,由需要时或所属技能创建。 Phase 4 报告:按固定格式输出创建、跳过、按设计不搭建、TODO(verify) 数量、NEXT STEPS 及事实表行;报告为最终消息,需原样输出。
限制:只增不覆,更新既有文件须人工 diff 审查;绝不触碰项目目录之外的内容;全局事实表行仅供用户粘贴,不由技能代填。