scaffold

脚手架

创建一个有明确边界的项目、组件或 CI 脚手架。此专用工具不会安排 RPI、创建工作归属、修改 Git，也不会决定下一步要做什么。

提示词

Scaffold a new CI workflow at fleet-router/.github/workflows/lint.yml plus a matching test fixture. Declare the exact paths to create, refuse to overwrite any existing file, generate a behavioral test for the new lint step, then run the target's build, test, and lint commands once and report results.

成功标准

• 报告会在任何写入操作发生前，声明将创建的确切路径，例如 .github/workflows/lint.yml。
• 如果路径与现有文件冲突，例如 .github/workflows/lint.yml 已存在，则拒绝操作并报告，且保持原文件不变。
• 生成的代码至少附带一个行为测试，例如 lint_test.go。
• 构建、测试和 lint 命令（例如 go build ./...）各运行一次，并在报告中引用其原始输出。

契约

1. 确定请求的目标根目录，并声明可能创建或修改的确切路径。
2. 未经调用方明确授权，不得覆盖现有路径。
3. 生成符合惯例且可正常工作的文件，并为生成的行为至少添加一个测试。
4. 各运行一次目标选定的构建、测试和 lint 命令。
5. 报告已更改的文件及命令的实际结果，然后停止。

除非调用方明确要求使用其他运行环境，否则使用当前 Agent 和本地 shell。保留无关的现有更改。

克隆经过验证的范例

在设计结构之前，先找到一个可正常工作的范例——在此代码库或目标生态系统中，找到一个已有且能够构建、测试并发布的项目、组件或 CI 文件，并根据请求克隆其结构，重命名并删减内容。只有在不存在范例时才自行设计结构，并在报告中说明。如果存在经过验证的范例，却仍设计全新布局，这就是空白页脚手架失败模式：每项自行发明的惯例，都是一个未经评审、如今需要由目标团队负责的决定。停止条件：如果两个候选范例在结构选择上存在分歧，则选择其验证命令目前能够通过的那个，并记录选择；不要混合两者。

单一事实来源，单向同步

如果脚手架包含派生或重复的内容（生成的配置、镜像常量、模板化 CI 矩阵），则必须指定唯一的事实来源，并让所有副本以单向、原子化的方式从该来源生成——单个再生成步骤即可生成所有副本；脚手架自身的文档或检查必须明确规定，手动编辑副本是错误的。需要凭记忆同步编辑的两个文件，就是双文件编辑陷阱失败模式；包含这种情况的脚手架并不完整。如果请求要求双向同步，则停止并报告冲突，不要搭建脚手架。

模式

• 请求语言和名称时，创建项目。
• 请求组件类型和名称时，向现有项目添加组件。
• 请求 CI 平台时，创建所请求的 CI 配置。

如果请求未指定目标或语言，只询问缺失的信息。版本控制、修订和交付由调用方负责。

证据

返回：

• 目标根目录和实际更改的路径；
• 选定的构建、测试和 lint 命令；
• 每条命令的退出代码；
• 未运行的任何所请求检查。

结果不得包含结论、生命周期状态、重试说明或后续操作。

参考资料

• references/generic-templates.md — 调用方需要特定模板时可参考的历史结构。
• references/agent-facing-tool-scaffolds.md
• references/scaffold.feature