everything-claude-code

AI4PB Orchestrator

AI4PB Orchestrator 是一个 VS Code 扩展，用来把企业架构模型、AI 编码执行、设计审计和迭代复盘串成一条可重复的交付流程。

它面向的不是“随便让 AI 帮我写点代码”的场景，而是“让 AI 在架构约束下参与真实项目交付”的场景。

这个项目解决什么问题

很多团队开始用 AI 写代码后，会很快遇到几个问题：

• AI 不知道系统设计边界，只能根据局部上下文生成代码
• 架构图、任务、缺陷、代码和复盘分散在不同工具里
• 代码可能能跑，但不一定符合原始设计职责
• 迭代结束后，缺少可追踪的审计和总结产物

AI4PB 的解决方式是：

1. 在 Sparx EA 中维护架构、Task、Issue。
2. 导出机器可读的架构上下文和任务文档。
3. 在 VS Code 中通过工作流面板驱动 Coding Agent 执行。
4. 在每轮 Sprint 中，按 规划 → 启动 → 执行 → 修复 → 审计 → 收尾 → 总结 → 汇报 的节奏推进，所有阶段均在 AI4PB 侧边栏一键触发。

一句话概括：

不是让 AI 自由发挥，而是让 AI 在你的架构和流程里工作。

你可以用它做什么

• 从 EA 模型导出当前迭代的 AI 输入
• 让 Copilot/Opencode 基于架构任务启动开发，而不是靠临时提示词
• 为具体任务生成执行说明并进入编码
• 根据 Issue 继续多轮修复
• 审计代码与架构是否偏离
• 自动沉淀任务清单、审计报告、提交说明和周报

用这个项目的收益

• 更少跑偏：AI 输入来自架构和任务，不是零散聊天上下文
• 更易协作：架构师、开发、测试、管理看到的是同一条流程
• 更可追踪：从 Task 到代码，再到审计和复盘都有对应产物
• 更易治理：每轮迭代都可以检查代码是否仍符合设计
• 更快复用：常见 SCRUM 阶段已经封装成现成动作

它是怎么工作的

AI4PB 把工作分成两端：

• 架构端：在 EA 中建模、挂载 Task/Issue、导出上下文
• 执行端：在 VS Code 中驱动 AI 按流程执行（扩展同时兼容 GitHub Copilot 和 OpenCode，可在 .aicodingconfig 中按需切换，详见下方"快速开始"章节）

核心闭环如下：

1. 在 EA 中维护架构和任务
2. 从 EA 导出 design/KG/SystemArchitecture.json
3. 在 AI4PB 侧边栏点击 计划与汇报流 -> 提取任务，自动生成任务清单（design/tasks/taskandissues_for_LLM.md）
4. 按 SCRUM 节奏完成后续迭代阶段：Init（启动）→ Task Support（执行）→ Iteration Issues（问题反馈与修复）
5. 执行 Design Audit 做架构对齐检查
6. 完成 Wrap-up、Iteration Summary、Weekly Report，收尾本轮迭代

快速开始

1. 准备环境

• Sparx Enterprise Architect 15+
• VS Code 1.95+
• GitHub Copilot
• AI4PB Orchestrator 扩展
• OpenCode（可选，用于替代或补充 Copilot 引擎）：
  • 在 WSL 中安装：npm install -g opencode-ai
  • 在 WSL 中启动服务：opencode serve（默认监听 http://127.0.0.1:4096）
  • 在项目的 .aicodingconfig 中配置地址与路由策略，示例如下：

{
  "AGENT_ROUTER_CONFIG": {
    "default_agent": "opencode",
    "opencode": {
      "transport": "server",
      "executionHost": "wsl",
      "server": {
        "baseUrl": "http://127.0.0.1:4096"
      }
    }
  }
}

2. 安装扩展

如果你是使用者：

• 从 Marketplace 安装，或
• 本地构建 VSIX 后安装

如果你是维护者，在仓库根目录执行：

npm install
npm run compile
npm run release:vsix:nobump

3. 初始化工作区

打开 VS Code 后：

1. 打开 AI4PB 侧边栏
2. 在侧边栏中点击 初始化 EA 模板 按钮
3. 在工作区中生成模板和流程基础文件

4. 在 EA 中准备 AI 输入

在架构元素上挂载 Task / Issue，建议遵循：

• Status = Active
• Assigned To = llm
• Name 写成可执行任务说明

然后从 EA 导出：

• design/KG/SystemArchitecture.json

任务清单（design/tasks/taskandissues_for_LLM.md）由扩展在执行 提取任务 步骤时自动生成，无需从 EA 手动导出。

5. 在 VS Code 中驱动迭代

当前 AI4PB 侧边栏中的主操作按钮如下，按钮名称与界面保持一致：

区域	当前侧边栏动作名称	说明
环境配置	EA模板初始化	初始化 EA 模板与基础工作区结构
环境配置	初始化AICodingAgent配置	将扩展内置的 .github、.opencode、skills、.agents、.claude、rules 初始化到当前工作区
环境配置	EA导出参数配置	配置 .aicodingconfig / .aicodingconfig.json 中的导出与维护参数
环境配置	参数查询	查看当前导出参数摘要
计划与汇报流程	提取任务	从 design/KG/SystemArchitecture.json 中提取维护任务并生成任务反馈输入
计划与汇报流程	待办梳理	生成当前迭代待办清单
计划与汇报流程	周报输出	生成管理层周报
执行支持流程	执行支持	为任务生成执行说明并进入实现支持
SCRUM敏捷开发流程	待办梳理	回看当前 Sprint 的优先级与待办范围
SCRUM敏捷开发流程	迭代启动	为本轮迭代建立上下文、范围和目标
SCRUM敏捷开发流程	问题反馈	打开问题反馈编辑页，回填 ResolverNotes 并确认写入反馈
SCRUM敏捷开发流程	问题处理	根据 Issue 记录继续多轮缺陷修复
SCRUM敏捷开发流程	迭代收尾	对本轮交付范围做收尾检查
SCRUM敏捷开发流程	提交总结	生成提交总结与 Git Commit Message
设计审计流程	设计审计	执行代码与架构对齐审计并输出 design/temp/audit.md

切换 AI 引擎（Copilot / OpenCode）

扩展默认使用 GitHub Copilot。若需切换为 OpenCode，在项目根目录 .aicodingconfig 中修改：

{
  "AGENT_ROUTER_CONFIG": {
    "default_agent": "opencode"
  }
}

也可仅对特定阶段路由到 OpenCode，其余阶段保持 Copilot：

{
  "AGENT_ROUTER_CONFIG": {
    "default_agent": "copilot",
    "task_specific_agents": {
      "task-list": "opencode"
    }
  }
}

6. OpenCode 集成包与传输模式

AI4PB 并不是只“调用一个外部 OpenCode 命令”这么简单。扩展本身内置了一套 .opencode 资产包，用于把 OpenCode 作为可初始化、可复制、可治理的执行环境接入工作区。

这套内置资产至少包括：

• OpenCode 插件包骨架与入口（.opencode/package.json、.opencode/index.ts）
• ECC Hook 插件实现（.opencode/plugins/*）
• 自定义工具包（.opencode/tools/*），包含 run-tests、check-coverage、security-audit、format-code、lint-check、git-summary
• 与 OpenCode 对齐的技能镜像与配置文件（.opencode/skills/*、.opencode/opencode.json）

扩展当前支持两种 OpenCode 传输模式，统一通过 .aicodingconfig 的 AGENT_ROUTER_CONFIG.opencode 配置：

• transport = "cli"：直接调用本机或 WSL 中的 opencode 命令，适合本地命令式执行
• transport = "server"：通过 opencode serve 暴露的 HTTP 服务进行会话创建、事件订阅与流式响应，适合常驻服务模式

此外，扩展会根据 executionHost、wslDistribution、server.directory、server.workspace 等配置自动处理 Windows 与 WSL 路径归一化，保证 CLI 模式和 Server 模式都能在同一工作区路由规则下工作。

核心使用方式：AI4PB 侧边栏

安装扩展后，VS Code 左侧活动栏出现 AI4PB DEV 图标，点击后打开工作流面板。

面板按 SCRUM 阶段排列，提供从架构初始化到迭代复盘的全套操作入口：

• 点击任意阶段按钮，扩展自动将架构上下文和专属指令注入 AI 会话
• 使用 GitHub Copilot 时：自动开启新 Chat 对话，架构 JSON 和角色 Prompt 随之注入
• 使用 OpenCode 时：既可以走本地 CLI，也可以走 opencode serve 的 Server 模式；两种模式都会由扩展统一接管并在面板内展示执行反馈

不需要手动复制 Prompt，不需要记忆命令，每个迭代阶段都有一键操作入口。

主要产物

业务交付物：

• implementation/task-list.md
• implementation/taskhelpinfos/*.md
• implementation/reports/*.md

过程工件：

• design/temp/audit.md
• debug/iteration-commit-message.md