10cg Agent 配置生成器
基于覆盖度缺口分析,生成项目专属 Agent 配置。
使用场景
- "根据缺口报告生成 Agent"
- "给这个项目创建一个数据库专家 Agent"
- agent-gap-analyzer 之后的第三步
前置条件
.aria/coverage-report.yaml存在 (由 agent-gap-analyzer 生成)- 用户已确认需要生成的 Agent 列表
流程
1. 读取缺口
从 .aria/coverage-report.yaml 的 gaps[] 读取:
- suggested_agent.name
- suggested_agent.capabilities
- suggested_agent.scope
2. 匹配技术栈模板
按项目 tech_stack 选择模板:
- 模板目录:
${CLAUDE_PLUGIN_ROOT}/skills/agent-creator/templates/ - 优先匹配具体技术栈, fallback 到 generic
3. 生成 Agent 定义
使用 few-shot exemplar (参考 code-reviewer + backend-architect 的结构) 生成:
frontmatter (STCO + capabilities):
---
name: <name>
description: |
<Scope: 领域名词>
Use when: <触发场景>. NOT for <消歧>.
Expects: <输入>
Produces: <产出>
capabilities:
- <tag1>
- <tag2>
model: sonnet
color: green
---
body 最低质量标准:
- Focus Areas: 3+ 项
- Approach: 3+ 步骤
- Output: 2+ 类产出
- 不超过 60 行
4. 预览 + 确认
- 默认: 展示生成的 Agent 完整内容, 等待用户确认
--dry-run: 仅展示不写入--confirm: 跳过预览直接写入
5. 写入
- 路径:
.aria/agents/<name>.md - 自动创建
.aria/agents/目录 (如不存在)
同名保护
写入前检查:
.aria/agents/<name>.md已存在 → 警告 "项目级 Agent 已存在, 是否覆盖?"- 插件级
agents/<name>.md同名 → 警告 "将覆盖插件级 Agent 路由, 确认?"
重要
- 生成的 Agent 用于项目级, 不提交到 aria-plugin
- body 质量依赖 LLM, few-shot exemplar 提升一致性
- 人工确认是必须步骤, 不可跳过 (--confirm 仅用于脚本/自动化)