init-agents-config

初始化 Agent 配置

根据 Skill("init") 期间收集的用户答案，组装 .agents.yml。

资源

资源	用途
CONFIG_VERSION	当前 .agents.yml 架构版本
assets/rails.yaml	Rails 配置模板
assets/python.yaml	Python 配置模板
assets/node.yaml	Node 配置模板
assets/generic.yaml	通用配置模板
references/agents-md-template.md	AGENTS.md 最佳实践
assets/local-config-template.yaml	本地覆盖项模板

按技术栈选择模板

技术栈	模板
Rails	assets/rails.yaml
Python	assets/python.yaml
Node	assets/node.yaml
通用	assets/generic.yaml

组装说明

1. 根据检测到的 tech_stack 读取相应模板
2. 将占位符替换为收集到的答案：
   • {{config_version}} - 从 CONFIG_VERSION 文件读取
   • {{owner_level}} - beginner、intermediate、senior、expert
   • {{task_management}} - github、linear、beads、file、none
   • 用户答案中的特定技术栈字段
3. 根据条件包含或排除各部分：
   • 如果未选择 Solid gems，则移除 extras: 部分（Rails）
   • 如果未检测到设计系统，则移除 toolbox.build_task.design_system_path
   • 除非用户选择了非 Chrome 浏览器，否则注释掉 browser: 部分
4. 写入 .agents.yml

条件部分

任务跟踪

默认注释掉（选择启用）。仅当用户明确启用任务跟踪时取消注释：

• task_tracking.enabled - 在工作流中创建任务，以便查看进度
• task_tracking.ledger - 用于崩溃恢复的 YAML 检查点
• task_tracking.ledger_path - 工作流账本文件的路径
• task_tracking.auto_cleanup - 工作流完成后移除任务

质量门审查者

每种技术栈都有默认审查者。仅在用户启用可选审查者时才包含：

• dhh-code-reviewer - Rails 严格风格
• data-integrity-reviewer - 迁移安全性
• codex-reviewer / gemini-reviewer - 外部 LLM

浏览器配置

默认注释掉（使用 Chrome）。仅当用户选择 Brave 或 Edge 时取消注释。

Extras（仅限 Rails）

仅包含用户选择的 Solid gems：

• solid_cache
• solid_queue
• solid_cable

输出

将生成的配置写入项目根目录下的 .agents.yml。