2026 现代 AI 智能体开发实战：用 MCP 与开源 Skills 打造端到端自主研发流水线

┌────────────────────────────────────────────────────────┐
│                   Agentic Runtime                      │
│   (State Machine + Reflection + Human-in-the-Loop)     │
└───────────┬────────────────────────────────┬───────────┘
            │                                │
            ▼                                ▼
┌────────────────────────┐      ┌────────────────────────┐
│   Skills 技能仓库       │      │   MCP 工具协议层        │
│ (按需加载的高阶工作流)   │      │ (安全沙箱与环境能力连接) │
│ - Issue 分类与上下文定位│      │ - Local FS & Shell     │
│ - 跨文件重构执行规范   │      │ - Git & GitHub API     │
│ - 测试用例与回归守护   │      │ - MySQL & Redis 连接器 │
└────────────────────────┘      └────────────────────────┘

{
  "mcpServers": {
    "repo-workspace": {
      "command": "mcp-server-filesystem",
      "args": ["/workspace/my-app"]
    },
    "safe-runner": {
      "command": "node",
      "args": ["./tools/sandbox-runner.js"],
      "env": {
        "ALLOWED_COMMANDS": "git,npm,npx,pytest",
        "TIMEOUT_MS": "60000"
      }
    }
  }
}

---
name: bugfix-and-pr
description: 用于自动修复 Bug、补充回归测试并生成 Pull Request 的高阶工作流
triggers:
  - issue_type: bug
  - label: auto-fix
---

# Bug 修复标准执行流程

当你处理 Bug 修复任务时，必须严格遵守以下步骤：

1. **复现 Bug**：
   - 阅读 Issue 描述，根据报告的堆栈或操作步骤，优先编写一个必定失败的端到端或单元测试用例。
   - 运行测试，确认测试失败（Red Phase）。
2. **定位与最小化修改**：
   - 仅修改与该 Bug 直接相关的代码行，严禁借机进行无关的代码格式重排或依赖升级。
   - 保持原代码的命名风格与错误处理约定。
3. **本地验证与回归测试**：
   - 运行新编写的测试，确认测试通过（Green Phase）。
   - 运行全量测试套件（`npm test` 或 `pytest`），确保没有破坏已有功能。
4. **生成规范的 Commit 与 PR**：
   - 分支命名规范：`fix/issue-<id>-<short-description>`。
   - PR 描述中清晰包含：Bug 根本原因、修复方案、测试验证结果与相关的 Issue 关联引用。

export async function runAutonomousBugfix(issueId: string, repoPath: string) {
  const issue = await fetchIssueDetails(issueId);
  console.log(`[Agent] 开始处理 Issue #${issueId}: ${issue.title}`);

  // 1. 检出临时修复分支
  const branchName = `fix/issue-${issueId}`;
  await runSandboxCommand(`git checkout -b ${branchName}`);

  // 2. 初始化智能体上下文
  const agentSession = await initAgentSession({
    skills: ["bugfix-and-pr", "codebase-researcher"],
    tools: ["read_file", "edit_file", "run_test_command"],
    systemPrompt: `你是一名资深工程师，你的目标是解决以下 Issue 并保证全套测试通过：\n${issue.body}`
  });

  let maxIterations = 8;
  let testPassed = false;

  while (maxIterations-- > 0 && !testPassed) {
    const step = await agentSession.nextStep();

    if (step.action === "run_test") {
      const testResult = await runSandboxCommand("npm test");
      if (testResult.exitCode === 0) {
        console.log("✅ 单元测试与回归测试全数通过！");
        testPassed = true;
        break;
      } else {
        // 将测试失败的完整 stderr 回传给 Agent，让其进入反思与二次修复
        agentSession.feedObservation({
          status: "FAILED",
          errorOutput: testResult.stderr || testResult.stdout
        });
      }
    }
  }

  if (testPassed) {
    await runSandboxCommand(`git commit -am "fix: resolve #${issueId} - ${issue.title}"`);
    await runSandboxCommand(`git push origin ${branchName}`);
    const prUrl = await createPullRequest({
      title: `fix: resolve #${issueId} - ${issue.title}`,
      body: `自动由 Agent 研发流水线完成修复并通过全量测试。\nCloses #${issueId}`,
      head: branchName,
      base: "main"
    });
    console.log(`🎉 PR 创建成功: ${prUrl}`);
  }
}