Agent.md 生成器

通过交互式提问生成高质量的 GitHub Copilot agents.md 文件。

工作流程概览

1. 识别代理类型 - 确定代理的用途
2. 收集项目上下文 - 获取技术栈和目录结构
3. 定义命令 - 确定可执行命令
4. 建立边界 - 设置明确的行为规则
5. 生成文件 - 创建 agents.md 文件

交互式提问流程

阶段一：代理身份

首先询问这些问题（每条消息 1-2 个问题，避免信息过载）：

必要问题：

• "这个代理应该处理什么具体任务？"（如：编写测试、文档、代码检查）
• "代理应该扮演什么角色？"（如：QA 工程师、技术写作人员）

如果用户不确定，建议以下代理类型：

• docs-agent - 技术文档编写
• test-agent - 单元测试/集成测试
• lint-agent - 代码风格和格式化
• api-agent - API 端点开发
• security-agent - 安全分析
• dev-deploy-agent - 构建和部署

阶段二：项目上下文

技术栈：

• "你的技术栈是什么？（框架、语言、版本）"
• 示例："React 18 + TypeScript + Vite + Tailwind CSS"

目录结构：

• "你的项目结构是怎样的？哪些目录与此代理相关？"
• 重点关注：源代码位置、测试位置、文档位置、配置文件

阶段三：命令

收集代理可使用的可执行命令：

• "代理应该运行哪些命令？（构建、测试、检查等）"
• "请包含具体的参数和选项，而不仅仅是工具名称"

需要询问的命令示例：

• 构建：npm run build、cargo build
• 测试：npm test、pytest -v、go test ./...
• 检查：npm run lint --fix、prettier --write
• 文档：npm run docs:build、markdownlint docs/

阶段四：边界

收集三层边界规则：

询问："代理应该始终做什么、需要先询问什么、永远不能做什么？"

• 始终执行：代理应自动执行的操作
• 先询问：需要用户确认的操作
• 永不执行：严格禁止的操作

常见边界示例：

• 永不提交密钥或 API 密钥
• 永不修改 node_modules/ 或 vendor/
• 修改数据库模式前先询问
• 添加依赖前先询问

阶段五：代码风格（可选）

如果用户需要代码风格指导：

• "你能提供一个展示你首选风格的代码示例吗？"
• "你遵循什么命名规范？"

生成模板

在 .github/agents/{agent-name}.md 生成 agents.md 文件：

---
name: {agent_name}
description: {一句话描述}
---

你是这个项目的专业{角色}。

## 你的职责
- 你专注于{专业领域}
- 你理解{领域知识}
- 你的输出：{预期输出}

## 项目知识
- **技术栈：** {带版本的技术栈}
- **目录结构：**
  - `{目录1}/` - {用途}
  - `{目录2}/` - {用途}

## 可用命令
- **{命令类别}：** `{命令}` ({描述})

## 代码规范
{如果提供了代码风格示例}

## 边界
- 始终执行：{始终执行的规则}
- 先询问：{需要询问的规则}
- 永不执行：{禁止的规则}

质量检查清单

生成前验证：

• 定义了具体角色（不是"有用的助手"）
• 技术栈包含版本号
• 命令包含参数/选项
• 三层边界清晰明确
• 文件路径明确
• 如果风格重要，至少有一个代码示例

输出

将生成的文件保存到 .github/agents/{agent-name}.md，并向用户提供：

1. 完整的文件内容
2. 审查和调整命令的说明
3. 建议在 Copilot 中使用 @{agent-name} 测试