PuaSE

全局编排 Agent — AI 编程流程化 · 防欺诈 · 门禁驱动 · 闭环交付

▸ 了解架构 ★ GitHub
— Stars · — Visits

PuaSE 是什么

解析需求

捕获显式需求 → 推导隐含需求 → 识别约束 → 拆解任务 → 确定优先级

委派专家

根据任务类型选择最合适的专家 Agent，传递完整上下文，注入行为协议

质量门禁

security-expert + code-reviewer + quality-inspector 三方并行，任一不通过立即打回重做

验收归档

输出委派链记录 → reflector 复盘（条件触发）→ 强制输出 KPI 卡（🧪+🔍+🛡️+📋+🔄）→ 改进跟踪至闭环

系统架构

PuaSE 全局编排器
解析需求 → 成熟度评估 → 委派专家 → Post-Code并行验收 → 委派链记录 → 复盘（条件触发）→ KPI卡
委派 ↓
Pre-Code 前置分析
  • architect
Execution 执行层
Developer
  • java-developer · python-developer
  • go-developer · rust-developer
  • csharp-developer · cpp-developer
  • web-developer
DBA
  • mysql-dba · oracle-dba · postgresql-dba
文档
  • documenter
Post-Code 质量门禁
  • security-expert
  • code-reviewer
  • quality-inspector
闭环 交付验收
  • KPI 验收卡
  • reflector 复盘总结

17 个子 Agent

三层架构，各司其职 — 点击卡片查看详情

🔍 Pre-Code 前置分析

architect
架构分析（full 深度设计 / quick 轻量扫描）

💻 Execution 执行层

Developer 多语言开发者

java-developer
Java 开发
python-developer
Python 开发
go-developer
Go 开发
rust-developer
Rust 开发
csharp-developer
C# 开发
cpp-developer
C/C++ 开发
web-developer
Web 前端开发

DBA 数据库管理

mysql-dba
MySQL 管理
oracle-dba
Oracle 管理
postgresql-dba
PostgreSQL 管理

文档

documenter
文档编写

🛡️ Post-Code 质量门禁

security-expert
安全审计
code-reviewer
代码审查
quality-inspector
质量巡检

✅ 闭环 交付验收

KPI 验收卡
门禁强制输出
reflector
反思总结

核心能力

隐含需求解析

5 步法：捕获显式需求 → 推导隐含需求 → 识别约束 → 拆解任务 → 确定优先级

代码库成熟度评估

快速判断项目处于初期/成长/成熟阶段，自动适配策略

先架构后代码

不读通架构不写代码，不画清依赖不修改。架构分析作为所有决策的上下文基础

专家委派体系

20 位专家 Agent 覆盖架构、开发、DBA、安全、审查、巡检、复盘全链条

上下文隔离原则

所有专家任务在独立子 Agent 会话中执行，主上下文仅保留编排决策所需最小信息，避免专家工作日志污染编排层

技能编排优化

将执行类 Skill（如 brainstorming/TDD/调试）翻译为委派策略交给对应 Agent，自身不执行技能中的"你来做"指令

KPI 验收卡 · 门禁铁律

没有 KPI 卡的交付叫自嗨。Post-Code 默认并行 security-expert + code-reviewer + quality-inspector，任一不通过立即打回

异常处理 · 压力升级

指数退避重试、Agent 熔断降级、L0-L4 压力升级、关键路径保护

快速上手

PuaSE — 终端
$ @PuaSE 帮我分析项目架构
→ 启动 architect 子 Agent（独立上下文）...
├─ 目录结构 · 模块依赖 · 数据流
├─ C4 模型 · ADR · 风险评估
└─ 子 Agent 返回结果摘要 ✅
$ @PuaSE 开发一个新的 Java 功能
→ 子 Agent 1: architect 架构设计
→ 子 Agent 2: java-developer 编码实现
→ 三家并行验收（各自独立上下文）:
├─ security-expert 审计 ✅
├─ code-reviewer 审查 ✅
└─ quality-inspector 巡检 ✅
$ @PuaSE 更新 README 和 website
→ 子 Agent 1: documenter 更新 README（独立上下文）
→ 子 Agent 2: web-developer 更新 website（独立上下文）
→ PuaSE 主上下文只做合并 + 验收
🧪 测试验证 + 🔍 代码检视 ✅
$ @PuaSE 审计代码安全
→ 委派 security-expert 子 Agent...
17 维度安全审计 · OWASP Top 10 · CWE
🟢 全部通过
$ @PuaSE brainstorm 新功能设计方案
→ brainstorming 产出 spec ✅
└─ 判断: 涉及新模块 + 架构变更 → 加载 writing-plans
→ 按 plan 迭代执行 → 触发 Post-Code 门禁:
├─ security-expert + code-reviewer + quality-inspector 并行
├─ 输出委派链记录 + reflector 复盘（条件触发）
├─ 强制生成 KPI 卡（七条件：🧪+🔍+🛡️+📋+🔄+影响面+委派链）
└─ 全部通过 ✅

快速开始

安装

前置条件

安装

将仓库中的 Agent 配置拷贝到 OpenCode 的 agents 目录：

# Windows PowerShell git clone https://github.com/zeekling/PuaSE.git Copy-Item -Recurse -Force .\PuaSE\subagent, .\PuaSE\PuaSE.md "$env:USERPROFILE\.config\opencode\agents\PuaSE\"
# Linux / macOS git clone https://github.com/zeekling/PuaSE.git cp -r ./PuaSE/subagent ./PuaSE/PuaSE.md ~/.config/opencode/agents/PuaSE/

验证安装

  1. 重启 OpenCode
  2. 确认默认 Agent 为 "PuaSE"
  3. 运行编排任务测试（如 @PuaSE 帮我分析项目架构）

安装后所有子 Agent 自动注册在主 Agent 下，无需手动维护 opencode.json 的 agent 条目。

贡献

欢迎为 PuaSE 贡献！流程简单透明：

  1. Fork 本仓库
  2. 修改或新增 Agent 配置
  3. 同步更新 subagents: 列表
  4. 提交 Pull Request
查看贡献指南 →