PuaSE

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

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

PuaSE 是什么

📋

解析需求

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

→
🤖

委派专家

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

→
🛡️

质量门禁

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

→
📋

验收归档

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

系统架构

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

20 个子 Agent

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

🔍 Pre-Code 前置分析

🏗️
architect
架构分析（full 深度设计 / quick 轻量扫描）
📂
explore
代码库探索

💻 Execution 执行层

Developer 多语言开发者

☕
java-developer
Java 开发
🐍
python-developer
Python 开发
🔵
go-developer
Go 开发
🦀
rust-developer
Rust 开发
#️⃣
csharp-developer
C# 开发
⚡
cpp-developer
C/C++ 开发
📊
bigdata-developer
大数据开发
🌐
web-developer
Web 前端开发

DBA 数据库管理

🗄️
mysql-dba
MySQL 管理
🏛️
oracle-dba
Oracle 管理
🐘
postgresql-dba
PostgreSQL 管理

通用 通用任务 & 文档

🔧
general
通用任务
📝
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 卡（七条件：🧪+🔍+🛡️+📋+🔄+影响面+委派链）
└─ 全部通过 ✅

快速开始

📦 安装

前置条件

  • OpenCode 已安装并配置
  • Node.js >= 18

推荐：npm 安装（版本管理）

npm install @zeekling/puse

安装后，在 opencode.json 的 plugins 数组中添加：

{"plugins": ["@zeekling/puse"]}

验证安装

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

插件模式下，所有子 Agent 由插件自动注册，无需手动维护 opencode.json 的 agent 条目。

本地打包

使用 npm pack 在本地打包为 tarball 文件：

npm pack

# 输出：+ @zeekling/puse-1.0.0.tgz

预览打包内容：npm pack --dry-run

包内容：.opencode/plugins/puse.js、subagent/、docs/、PuaSE.md、README.md、CONTRIBUTING.md、config_template.json

模型配置

支持通过 config_template.json 为不同子 Agent 单独配置模型，实现最优成本效益。

安装后如需修改，直接编辑 opencode.json 的 agent 字段后重启 OpenCode 即可生效。

卸载

bash PuaSE-uninstall.sh

Linux / macOS

.\PuaSE-uninstall.ps1

Windows PowerShell

🤝 贡献

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

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