AI导哈

BRD转工作项代理

Agent486是一个GitHub Copilot自定义代理，能够自动化将业务需求文档(BRD)转换为Azure DevOps或Jira中的分层工作项。

  • by PsHuliyappanavar
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 PsHuliyappanavar/MCP

使用说明

GitHub复制品自定义代理-Agent486

此存储库包含 代理商486，一个定制的GitHub Copilot代理，可以自动将业务需求文档（BRD）转换为Azure DevOps（ADO）或Jira中的分层工作项。

🚀 快速开始

先决条件

  1. GitHub Copilot Pro、Pro+、商业或企业版 订阅
  2. Azure DevOps 和 Jira 具有适当权限的帐户
  3. OAuth 2.0凭据 适用于ADO和/或Jira

代理配置选项

此存储库提供 二 代理配置：

  1. 存储库级代理 (.github/agents/agent486.md)

    • 供个人存储库使用
    • 需要在VS代码设置中单独配置MCP服务器
    • 用于测试或单个存储库部署

  2. 组织/企业级代理 (agents/agent486.md) ✅ 推荐

    • 适用于整个组织或整个企业
    • MCP服务器嵌入在具有秘密引用的YAML frontmatter中
    • 可在组织中的所有存储库中使用
    • 需要GitHub Copilot Business或Enterprise订阅

安装说明

⚠️ 适用于组织/企业用户：使用代理 agents/agent486.md （已配置MCP服务器）

选项A：用于本地VS代码使用

  1. 确保已安装Python 3.8+

  2. 安装所需的依赖项：

    pip install flask requests

  3. 通过添加以下内容在本地VS代码中配置MCP服务器 ~/.config/Code/User/globalStorage/github.copilot-chat/mcp.json （Mac/Linux）或 %APPDATA%\Code\User\globalStorage\github.copilot-chat\mcp.json （Windows）：

{
  "mcpServers": {
    "ado-mcp-server": {
      "command": "python",
      "args": ["path/to/deployMCP/ado_mcp_stdio.py"],
      "env": {
        "ADO_CLIENT_ID": "your-client-id",
        "ADO_CLIENT_SECRET": "your-client-secret",
        "ADO_TENANT_ID": "your-tenant-id"
      }
    },
    "jira-mcp-server": {
      "command": "python",
      "args": ["path/to/deployMCP/jira_mcp_stdio.py"],
      "env": {
        "ATLASSIAN_CLIENT_ID": "your-client-id",
        "ATLASSIAN_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

选项B：用于GitHub.com

GitHub.com上的GitHub Copilot要求MCP服务器可以通过HTTP端点访问。您需要将MCP服务器部署为web服务。（相关文档即将发布）

步骤2：配置GitHub机密

将以下机密添加到您的存储库中：

  1. 首选 设置→ 秘密和变量→ 代码空间
  2. 添加以下机密：

对于Azure DevOps：

  • ADO_CLIENT_ID：您的Azure AD应用程序客户端ID
  • ADO_CLIENT_SECRET：您的Azure AD应用程序客户端机密
  • ADO_TENANT_ID：您的Azure AD租户ID

对于Jira：

  • ATLASSIAN_CLIENT_ID：您的Atlassian OAuth客户端ID
  • ATLASSIAN_CLIENT_SECRET：您的Atlassian OAuth客户端密钥
如何获取Azure DevOps OAuth凭据
  1. 首选 Azure门户
  2. 导航至 Azure Active Directory→ 应用程序注册
  3. 点击 新注册
  4. 名称：“Agent486 ADO集成”
  5. 重定向URI: http://localhost:9001/oauth/callback
  6. 创建后，请注意 应用程序（客户端）ID 和 目录（租户）ID
  7. 首选 证书和秘密→ 新客户机密
  8. 立即复制机密值（不会再次显示）
  9. 首选 API权限→ 添加权限→ Azure DevOps
  10. 添加： user_impersonation （委托）
  11. 授予管理员同意
如何获取Jira OAuth凭据
  1. 首选 Atlassian开发人员控制台
  2. 点击 创建→ OAuth 2.0集成
  3. 名称：“Agent486 Jira集成”
  4. 添加回拨URL: http://localhost:9000/oauth/callback
  5. 添加权限：
    • read:jira-work
    • write:jira-work
    • write:project:jira
    • read:jira-user
    • manage:jira-project
    • manage:jira-configuration
    • offline_access
  6. 创建后，请注意 客户端ID 和 秘密
  7. 分发应用程序（OAuth流程所需）

步骤3：使用自定义代理

  1. 在GitHub.com上导航到您的存储库
  2. 打开 复制品代理选项卡
  3. 从下拉列表中选择您的存储库
  4. 你应该看看 代理人486 在代理列表中
  5. 在任何问题或PR中，单击Copilot图标并选择 代理人486 从下拉列表中
  6. 以如下提示开始：
    Transform this BRD into work items in Azure DevOps:
[Paste your BRD content here]

📁 存储库结构

deployMCP/
├── .github/
│   └── agents/
│       └── agent486.md          # Custom agent profile
├── ado_mcp_stdio.py             # Azure DevOps MCP server
├── jira_mcp_stdio.py            # Jira MCP server
├── Instructions.md              # Detailed operational instructions
├── mcp.json                     # Local MCP configuration (for AI Toolkit)
└── README.md                    # This file

🎯 代理能力

支持平台

  • Azure DevOps：Epic→ 特性→ PBI → 任务（4级层次结构）
  • Jira：Epic→ 故事→ 子任务→ Bug（4级层次结构）

主要特点

✅ 自主操作：98%以上的自动化，用户提示最少（只有2个验证门） ✅ 智能解析：基于LLM的BRD解析，置信阈值超过70% ✅ 分层创建：家长优先订购，自动关联关系 ✅ 验证：所有项目和层次结构链接的创建后验证 ✅ 幂等性：基于哈希的重复检测和预防 ✅ 错误恢复：指数级回退，带有恢复检查点 ✅ PII保护：自动检测和编辑敏感数据 ✅ 完全可追溯性：使用工具调用跟踪完成审计日志

工作流阶段

  1. 认证：具有自动刷新功能的OAuth 2.0
  2. 组织/项目发现：自动选择或提示选择
  3. BRD解析：提取FR/NFR分类要求
  4. 层次结构：建立亲子关系
  5. 置信度验证：根据置信度评分自动前进或重试
  6. 项目管理：创建或选择目标项目
  7. 类型映射：映射到平台特定的问题类型
  8. 审查门：用户对生成的层次结构的批准
  9. 创建与验证：带有强制验证的临时创建
  10. 工件生成：Markdown摘要和JSON跟踪日志

🛠️ MCP服务器工具

Azure DevOps工具(ado-mcp-server/*)

  • authenticate：OAuth 2.0身份验证
  • get_organizations：获取可用组织
  • create_project, get_project：项目管理
  • create_issue, update_issue, get_issue：工作项CRUD
  • search_issues：基于WIQL的批处理查询
  • get_issue_types：获取有效的工作项类型
  • clear_session：会话清理

Jira工具(jira-mcp-server/*)

  • authenticate：OAuth 2.0身份验证
  • get_all_projects：获取可访问的项目
  • create_project：项目创建
  • create_issue, update_issue, get_issue：发出CRUD
  • search_issues：基于JQL的批处理查询
  • get_issue_types：获取有效的问题类型
  • clear_session：会话清理

📊 成功指标

指标 目标
自动化率 ≥98%
用户提示 每次运行≤2
可追溯性 100%
响应时间 99%<每次呼叫15秒
层次结构完整性 100%有效链接

🔒 安全

  • OAuth 2.0：所有身份验证均通过行业标准OAuth进行
  • 秘密管理：用于凭证存储的GitHub存储库机密
  • PII保护：基于正则表达式的自动检测和编校
  • 审计日志：完全可追溯性 tool_call.id 传播
  • 最小特权：作用域令牌（ADO: vso.work吉拉： write:jira-work)

📝 用法示例

User: Transform this BRD into Azure DevOps work items:

# E-Commerce Platform Modernization

## Functional Requirements
1. User Authentication System
   - Social login integration (OAuth 2.0)
   - Multi-factor authentication
   - Password reset functionality

2. Product Catalog Management
   - Category hierarchy
   - Product search with filters
   - Inventory tracking

## Non-Functional Requirements
- Performance: Page load <2 seconds
- Security: PCI DSS compliance
- Scalability: Support 10K concurrent users

Agent486: Let's begin the process of transforming the E-Commerce Platform Modernization BRD
into hierarchical work items for Azure DevOps.

Phase 1: Authenticating with ADO via OAuth...
[Opens browser for authentication]

Completed: Authentication successful. Proceeding to Phase 2: Fetch organizations.

Phase 2: Fetching organizations from ADO.
Available organizations:
1. MyCompany (ID: abc123)
2. TestOrg (ID: def456)

Validation Gate: Reply with 'select_organization MyCompany' to proceed.

User: select_organization MyCompany

Agent486: Organization selected: MyCompany. Proceeding to Phase 3: Parse BRD.

Phase 3: Parsing BRD into requirements.
Extracted 6 items (4 FR, 2 NFR). Confidence: 92%.

Phase 4: Structuring into hierarchy.
Validated depth/links. Total items: 12 (including sub-items).

...

Phase 8: Generated Hierarchy for Review:

| Level   | Title                          | Type | Children |
|---------|--------------------------------|------|----------|
| Epic    | E-Commerce Platform Modernization | FR   | 2        |
| Feature | User Authentication System     | FR   | 3        |
| PBI     | Social login integration       | FR   | 2        |
| Task    | Implement OAuth 2.0 provider   | FR   | 0        |
...

Total: 12 items

Reply with 'approve' to create in ADO.

User: approve

Agent486: Review approved. Proceeding to Phase 9: Creating items and verifying hierarchies.

Created Epic CFP-1: E-Commerce Platform Modernization
Verified CFP-1: ✓
Created Feature CFP-2: User Authentication System
Verified CFP-2: ✓ (parent: CFP-1)
...

Phase 10: Closing session and generating artifacts.
Completed: Full run successful. Artifacts generated.

Summary: 12 work items created in Azure DevOps
- 1 Epic: CFP-1
- 2 Features: CFP-2, CFP-7
- 5 PBIs: CFP-3, CFP-4, CFP-5, CFP-8, CFP-9
- 4 Tasks: CFP-6, CFP-10, CFP-11, CFP-12

All items verified with 100% hierarchy integrity.

🐛 故障排除

常见问题

问题：“找不到MCP服务器”

  • 解决方案：确保MCP服务器在VS代码设置中配置或部署为GitHub.com使用的web服务

问题：“身份验证失败”

  • 解决方案：验证OAuth凭据是否正确，是否具有所需的权限。检查重定向URI是否完全匹配。

问题：“超出费率限制”

  • 解决方案：Agent486包括呼叫之间的自动1秒延迟。如果仍然达到极限，请检查使用API的其他进程。

问题：“层次结构验证失败”

  • 解决方案：审查BRD结构。确保需求可以分为最多4级层次结构。

调试模式

要启用详细日志记录，请设置环境变量：

export AGENT486_DEBUG=true

🤝 贡献

欢迎投稿！拜托：

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

📄 许可证

此项目按原样提供，用于GitHub Copilot。

📞 支持

对于问题或疑问：

  1. 检查 故障排除 章节
  2. 查看 说明.md 获取详细的操作指南
  3. 在此存储库中打开问题

代理商486 -将BRD转换为具有完全自动化和可靠性的有组织工作项。

相关 MCP