AI导哈

AI代理编排框架

一个生产就绪的AI代理编排框架，用于软件开发生命周期的需求分析、开发、代码审查、安全扫描和质量保障。

  • by clausfonnesbech
  • PowerShell
  • 本地部署
  • 更新于
在 GitHub 查看 clausfonnesbech/agentic-framework

使用说明

能动性人工智能框架

一个全面的、生产就绪的框架，用于在软件开发工作流程中编排专业的人工智能代理。该框架基于安全第一原则构建，使团队能够利用AI代理进行需求分析、开发、代码审查、安全扫描和质量保证。

🌟 特性

13名专业代理

  • 编排代理（项目经理）：所有工作的单一入口点——路由请求，在用户决策门之间自主运行管道，保护用户免受代理协调的影响
  • 业务分析代理：需求收集、用户故事创建、利益相关者分析
  • 行为重构剂：感知重构、低成本行为干预、实验设计——在做出承诺之前提出替代想法
  • 研究经理：研究协调、任务授权、综合
  • 研究代理：技术研究、比较分析、可行性研究
  • UX/UI代理：在详细设计之前，始终提供5个不同的设计方案供用户选择；无障碍合规性、设计系统
  • 任务管理器：史诗分解、冲刺计划、依赖关系映射
  • 技术主管：架构设计、技术协调、冲刺计划
  • DevOps/平台代理：编码前的基础设施/平台准备门、CI/CD和集成设置
  • 编程代理：在选定的项目堆栈中安全实施，并进行自我审查
  • 代码检查：代码质量审查、功能验证、测试覆盖率
  • 安保人员：安全扫描（Semgrep）、CVE检测、GDPR合规性——在每次发布前阻止端到端门
  • 测试技术总监：测试策略、自动化测试（剧作家）、故事级和冲刺级质量门

可重复使用的技能

技能是代理加载以增强其能力的模块化标记文档：

  • 安全：安全编码、秘密检测、依赖安全
  • 代码质量：代码审查清单、测试用例设计
  • 规划：冲刺计划、故事准备验证、积压计划估算
  • 研究：市场调研、比较分析、技术综合、来源评估
  • 设计：ui-ux研究，无障碍包容性设计
  • 品牌/客户合规性：atea设计合规性
  • 建筑：api设计、数据库设计、身份验证授权、实时通信
  • 工作流程：工作流自动化、文件存储安全
  • 心态：好奇心

9输出模板

标准化模板确保代理输出的一致性：

  • 用户故事模板.md：具有验收标准的用户故事，DoR/DoD
  • 研究报告模板.md：研究结果及证据和建议
  • sprint-plan-template.md：Sprint与依赖关系和风险评估的协调
  • 安全审查报告模板.md：Semgrep集成的安全扫描结果
  • 代码审查报告模板.md：代码质量审查和覆盖率分析
  • 测试计划模板.md：QA策略，包括手动和自动测试计划
  • ux审查报告模板.md：使用尼尔森启发式方法和WCAG合规性进行用户体验评估
  • 任务分解模板.md：史诗分解和工作量估算
  • proposal-template.md：带有商业案例的项目建议书

MCP服务器配置

模型上下文协议（MCP）服务器为代理提供对工具和数据的实时访问：

  • 源代码控制和规划集成
  • 工作流自动化集成
  • 数据/后端集成
  • 文档/参考集成
  • API规范/合同集成
  • 浏览器和UI验证集成
  • 安全扫描集成

看 mcp-servers/README.md 对于完整的可选库存。服务器激活是特定于项目的。

🚀 快速开始

目标：项目本地镜像（推荐）

如果您想：

  • 保持一个干净的真相来源框架仓库，
  • 使用可编辑 agents/, skills/, templates/, mcp-servers/，以及 shared/ 在你的项目中，
  • 确保项目编辑不会影响框架仓库，除非您明确地推送它们。

这是通过以下方式实现的：

  • 本地镜像克隆位于 .agentic-framework/ （git在你的项目中被忽略了），
  • 同步脚本位于 scripts/sync-framework.sh.

先决条件

  • Git
  • Bash shell（macOS/Linux或Windows上的Git Bash）
  • 支持MCP的AI助手

开始使用（镜像+同步）

  1. 转到您的项目根目录（现有或新）：

    cd /path/to/your-project

  2. 引导框架镜像到您的项目中：

    选项A（建议使用一个衬垫）：

    curl -fsSL https://raw.githubusercontent.com/clausfonnesbech/agentic-framework/main/scripts/bootstrap-sync.sh \
  | bash -s -- "$PWD"

    选项B（来自本地框架克隆）：

    /path/to/agentic-framework/scripts/bootstrap-sync.sh "$PWD"

  3. 确认镜像设置：

    ./scripts/sync-framework.sh status

  4. 需要时拉取框架更新：

    ./scripts/sync-framework.sh pull

隔离是如何工作的

  • 直接在项目路径中编辑框架文件(agents/, skills/等等）。
  • 您的编辑将提交到您的项目存储库，而不是框架存储库。
  • 框架克隆位于 .agentic-framework/ 并且被您的项目忽略 .gitignore.
  • 除非您明确运行以下命令，否则不会向上游发送任何内容：
    ./scripts/sync-framework.sh push "your message"

如果你从不跑步 push，您的项目特定代理自定义将保持项目本地。

MCP设置

  • 审查 mcp-servers/SETUP-GUIDE.md.
  • 仅启用所选项目堆栈所需的MCP服务器。
  • 在本地运行时环境中添加凭据/令牌。

基本用法

示例：启动开发Sprint

  1. 技术主管代理 创建冲刺计划：

    • 荷载： sprint-planning-skill.md, story-readiness-verification-skill.md
    • 使用MCP：GitHub（问题跟踪）+所选项目堆栈的任何堆栈相关文档MCP
    • 输出： sprint-plan-template.md

  2. 编程代理 实现功能：

    • 荷载： secure-coding-skill.md （总是第一个）
    • 使用MCP：堆叠适当的文档/工具MCP，以及Semgrep（自我审查）
    • 完成前执行安全自检

  3. 代码检查 审查实施情况：

    • 荷载： code-review-checklist-skill.md
    • 使用MCP：堆叠适当的文档和验证MCP
    • 输出： code-review-report-template.md
    • 使用编码代理最多5次迭代

  4. 安保人员 扫描代码：

    • 荷载： secure-coding-skill.md, secrets-detection-skill.md
    • 使用MCP:Semgrep（自动扫描-初级）
    • 输出： security-review-report-template.md
    • BLOCKS在关键问题上的承诺

  5. 测试技术总监 验证质量：

    • 荷载： test-case-design-skill.md
    • 使用MCP:Playwright（UI测试）
    • 输出： test-plan-template.md
    • 确认所有质量门均已通过

🏗️ 建筑

编排管道（推荐）

这 编排器代理 (agents/00-orchestrator-agent.md)是唯一的切入点。你给它任何要求——从最初的想法到一个小的更改请求——它都会运行整个流程，只在决策阶段涉及你：

USER ASK → Orchestrator (Project Manager)
   │
   ├── PRE-PHASE
   │     Business Analyst ──────────── GATE 1: approve proposal
   │     Research Manager → Research Agents (parallel)
   │     Behavioral Reframe Agent ──── GATE 2: review research + alternatives
   │     UX/UI Agent (5 proposals) ─── GATE 3: select a design
   │     UX/UI Agent (detailed design for chosen direction)
   │
   └── DELIVERY MODE
         Task Manager (phases/sprints) ─ GATE 4: approve plan
         Tech Lead (detailed stories)
         DevOps Agent (infra/MCP readiness gate)
         ┌──────────────────────────────────────┐
         │ Per story: Coding Agent ⇄ Code        │
         │ Inspector (max 3 rounds) → QA Lead    │
         │ (combined cap 5 → escalate to user)   │
         └──────────────────────────────────────┘
         QA Lead (full sprint regression) ─ GATE 5: sprint review
         Security Agent (end-to-end, blocking) ─ GATE 6: release approval

请求分诊： 赛道A （新项目——全线投产）， 轨道B （增强——缩写为预阶段）， 轨道C （小修复——直接到交付循环）。质量关永远不会被跳过。

在分类之前，编排者会披露该作品是否是Atea项目。如果Atea Design适用，代理团队将加载 skills/atea-design-compliance-skill.md 并在整个提案、用户体验/用户界面、实施、检查和质量保证过程中执行Atea品牌、设计系统、可访问性、组件和语调要求。

Agent协调模式（故事级循环）

Tech Lead (Coordinator)
    ↓
Coding Agent (Implementation)
    ↓
Code Inspector (Quality Review) ←┐ Max 5 iterations total
    ↓                              │
    ↓──────────────────────────────┘
QA Lead (Story Validation)
    ↓
Security Agent (Release Gate)
    ↓
✅ Ready for Commit

设计原则

  1. 安全第一：每个开发人员代理首先加载secure-coding-skill.md
  2. 迭代控制：用户升级前最多5次组合迭代
  3. 封锁大门：Security Agent阻止关键问题的提交
  4. 关注点分离：每个代理人都有具体的、不重叠的职责
  5. 技能模块化：技能可在多个代理之间重复使用
  6. 模板标准化：所有代理会话的输出一致
  7. MCP集成：实时访问工具和文档

关键工作流程

编排工作流（推荐）：

  • 编排器分类→ 运行预阶段（BA→ 研究→ 重新制订→ UX 5提案）→ 交付模式（任务管理器→ 技术主管→ DevOps之门→ 开发质量回路→ 冲刺QA→ 安全释放门）——用户仅在6个决策门参与

开发工作流程：

  • 技术主管协调→ 编码代理实现→ 代码检查器审查（迭代）→ QA主管验证故事→ 安全代理放行

研究工作流程：

  • 研究经理协调→ 研究代理人调查→ 研究经理综合→ 行为重构代理挑战与替代方案

规划工作流程：

  • 业务分析师收集需求→ 任务管理器分解史诗→ 技术主管计划冲刺

用户体验工作流程：

  • UX/UI Agent提出5个不同的建议→ 用户选择→ 详细设计→ QA负责人测试用户流

📚 文档

🔧 定制

添加新代理

  1. 在中创建新的代理定义 agents/ 目录
  2. 定义目的、能力、技能和MCP服务器
  3. 指定初始化指令和会话管理
  4. 文档代理在工作流协调中的作用

创建自定义技能

  1. 在中创建markdown文件 skills/ 目录
  2. 包括明确的目的、功能和使用示例
  3. 提供代码示例、检查表或程序
  4. 参考代理定义

扩展模板

  1. 在中创建模板 templates/ 目录
  2. 使用具有清晰部分的结构化格式
  3. 包括特定代理的指导
  4. 添加 templates/README.md 目录

添加MCP服务器

  1. 在中创建配置文件 mcp-servers/ 目录
  2. 定义功能和用例
  3. 文档安装和设置
  4. 更新 mcp-servers/README.md 和 SETUP-GUIDE.md
  5. 相关代理商的推荐信

🛡️ 安全

该框架在多个级别实现了安全性：

  • 安全编码技能：由所有开发代理作为首要任务加载
  • 秘密检测：对暴露的凭据进行基于模式的扫描
  • 依赖安全：CVE扫描和安全/pip审计
  • 自动扫描：OWASP Top 10的Semgrep集成
  • GDPR合规：Security Agent中的数据保护检查
  • 零容忍政策：BLOCK提交的关键安全问题
  • 迭代限制：最多5次迭代可防止无限的安全修复循环

🧪 测试

所需工具：

  • Semgrep: brew install semgrep 或 pip install semgrep （v1.151.0+）
  • 剧作家：通过MCP服务器配置用于UI测试
  • 项目试运行：使用项目选择的跑步者

安全扫描示例：

# Full security scan
semgrep scan --config=auto

# Optional stack-specific scan (only if relevant)
semgrep scan --config=<stack-specific-policy>

# Secrets only
semgrep scan --config=secrets

# OWASP Top 10
semgrep scan --config=owasp-top-ten

测试覆盖要求：

  • 总体：覆盖率超过80%
  • 关键路径：100%覆盖
  • 安全功能：100%覆盖

📊 使用示例

示例1：安全第一功能开发

Input: "Implement secure user profile password reset"

Tech Lead:
- Creates sprint plan with security requirements
- Assigns to Coding Agent
- Configures Security Agent gate

Coding Agent:
- Loads secure-coding-skill.md FIRST
- Implements password reset with:
   - Secrets stored in the project's secrets manager (never code)
  - CSRF protection
  - Rate limiting
  - Audit logging
- Performs security self-check before completion

Code Inspector:
- Reviews code quality and functionality
- Confirms test coverage >80%
- Validates selected-stack best practices
- PASS → sends to Security Agent

Security Agent:
- Runs Semgrep scan
- Checks for secrets exposure
- Validates secrets manager configuration
- GDPR compliance check
- PASS → ready for QA

QA Lead:
- Creates test plan
- Executes automated tests (Playwright)
- Validates all acceptance criteria
- PASS → ready for commit ✅

示例2：研究驱动的架构决策

Input: "Which backend stack should we use for our API?"

Research Manager:
- Creates research task breakdown
- Assigns comparative analysis to Research Agents

Research Agents:
- Load comparative-analysis-skill.md
- Use the most relevant docs MCPs for the candidate stacks
- Research performance, scalability, ecosystem
- Output: research-report-template.md

Research Manager:
- Synthesizes findings
- Provides recommendation with evidence
- Documents trade-offs

Tech Lead:
- Reviews research
- Makes architecture decision
- Documents in sprint plan

🤝 贡献

欢迎投稿！该框架旨在为各种工作流程进行扩展和定制。

贡献领域：

  • 不同域的新代理定义
  • 新兴技术的附加技能
  • 流行工具的MCP服务器配置
  • 模板改进和新格式
  • 文档和使用示例

指导方针：

  • 遵循现有的代理/技能/模板结构
  • 包括清晰的文件
  • 提供使用示例
  • 使用真实工作流进行测试
  • 更新相关的README文件

📝 许可证

[选择您的许可证：MIT、Apache 2.0等。]

🙏 致谢

基于模型上下文协议（MCP）标准，用于AI代理与工具和数据源的集成。

📞 支持

版本: 1.0.0
最后更新: 2026-02-15
状态：生产就绪

相关 MCP