用途:每个仓库完整执行一次的工程底座初始化/更新技能。其它工程技能通过运行 node .agents/scripts/precheck.mjs 判断是否已 setup,缺了就停,不会代跑本技能。仅当用户显式调用 setup 时使用。
主要能力与产物:创建 .agents/docs/ 与 .agents/cooking/(空目录),创建 .agents/scripts/ 并把 <engineering>/setup/scripts/ 整目录复制进去;在 .gitignore 追加 .agents/cooking/(若整个 .agents/ 被忽略则改为只忽略 cooking)。写 .agents/docs/PROJECT.md(类别、组织结构、全栈架构形态、一句「是什么」);代码类项目还写 ARCHITECTURE.md、DEV-STANDARDS.md、CODE-MAP.md,并把技能包模板原样复制为 SMELLS.md。按类别用 shell 复制 .agents/scripts/root-agents-code.md 或 root-agents-non-code.md 覆写根 AGENTS.md。
使用方式:确定工作目录(当前 workspace / git 根),有歧义必须先确认,确认前不写文件;随后按工作流执行目录创建、分类、文档写入,最后运行 node .agents/scripts/precheck.mjs,FAIL 则补缺直到 PASS。更新模式处理代码/非代码切换、脚本缺失、AGENTS.md 走样、docs 缺失等;docs 内容过时让用户跑 sync-docs。完成汇报后用交互式提问询问是否为编码加一层验收保障。
限制:precheck 运行时读同目录模板,三脚本与两模板缺一不可;SMELLS.md 禁止按项目改写、追加或删条;禁止把规范全文写回根 AGENTS.md,禁止删除 cooking/ 中进行中的功能;不生成 .agents/docs/ACCEPTANCE.md,不代跑 acceptance。具体脚本内容、模板细节与收费等信息资料未完整提供。