用途:依据已批准的架构与实施任务计划,为项目创建初始仓库结构或 monorepo 骨架,属于高风险文件写入类技能,需明确目标路径、审批范围、适配器选择、生成文件与跳过的操作。
主要能力:从已批准计划中识别前端、后端、API 契约、数据库、worker、agent、MCP 服务器或纯文档等组件;为已知技术栈路由到更强的专用脚手架技能(如 Angular 用 angular-new-app、Spring Boot/Java 用 dr-jskill、MCP 服务器用 mcp-builder、契约优先用 openapi-spec-generation、Olakai 监控 AI agent 用 new-project);在无适配器时创建保守回退结构;添加 README.md、.gitignore、.env.example、docs 与 setup 说明等仓库卫生文件;将架构、实施计划、项目约束等规划产物保存在 .agentspec/ 下;运行最轻量的本地验证,或在未获执行授权时给出确切验证命令。
使用方式:写文件前需确认目标路径(尽量解析为绝对路径)、已批准的架构与技术计划、已批准的实施任务计划、项目约束,以及文件创建、依赖安装、网络访问、Git 初始化、远程仓库创建和破坏性清理的审批边界。执行流程为确认输入与审批、检查目标路径、选择适配器与回退区域、创建目录与根文件、调用适用的技术栈适配器、归档规划产物、补充卫生文件、运行最轻量验证、更新 scaffold-report.md,最后按固定格式报告仓库路径、适配器、创建/变更内容、执行命令、验证结果、规划产物位置、跳过项与下一步。
限制:不用于选择架构、创建实施待办或实现脚手架级冒烟检查之外的业务功能;未经明确批准不得安装依赖、初始化 Git、创建远程仓库、提交、推送或发布,也不得覆盖已存在的非空目标目录。若缺少必要输入需请求最小澄清。每个组件优先运行快速、本地、确定性的验证;无法验证时说明原因并给出命令,不得在无证据时声称脚手架可用。命令失败时记录命令、工作目录、退出状态与错误,仅在批准范围内修复明显错误,遇到破坏性清理、全局变更、网络安装或需要重新批准的重试前停止,并留下可读的 scaffold-report.md,标出未完成区域。