PuaSE

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

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

PuaSE 是什么

📋

解析需求

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

→
🤖

委派专家

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

→
✅

闭环交付

默认并行验收 → 强制生成 KPI 卡 → 复盘闭环。security-expert + code-reviewer + quality-inspector 并行，任一不通过立即打回。无 KPI 卡的完成声明视为 P0 违规

系统架构

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

19 个子 Agent

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

🔍 Pre-Code 前置分析

🏗️
architect
完整架构分析
🔎
architect-scan
轻量级架构扫描
📂
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 管理

通用 通用任务 & 文档

🔧
general
通用任务
📝
documenter
文档编写

🛡️ Post-Code 质量门禁

🔒
security-expert
安全审计
👁️
code-reviewer
代码审查
✅
quality-inspector
质量巡检
🔄
reflector
反思总结

核心能力

🔍

隐含需求解析

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

📊

代码库成熟度评估

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

🏗️

先架构后代码

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

🔄

专家委派体系

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

🧊

上下文隔离原则

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

🎯

技能编排优化

将执行类 Skill（如 brainstorming/TDD/调试）翻译为委派策略交给对应 Agent，自身不执行技能中的"你来做"指令。brainstorming 产出 spec 后自动判断是否加载 writing-plans → 按计划委派开发者实现 → Post-Code 门禁 → KPI 卡闭环

📋

KPI 验收卡 · 门禁铁律

没有 KPI 卡的交付叫自嗨。Post-Code 默认并行 security-expert + code-reviewer + quality-inspector，任一不通过立即打回。子 Agent 声明完成前强制：验收 → KPI 卡 → 复盘，缺一视为 P0 流程违规。验收后执行自遵守审计清单确保新规则被遵守、操作有归因、跳过有理由；reflector 改进建议跟踪至闭环

⚡

异常处理 · 压力升级

指数退避重试、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 并行
├─ 强制生成 KPI 卡（验收标准量化）
├─ 全部通过 ✅
└─ 复盘闭环 🔄

快速开始

📦 安装

PuaSE 基于 OpenCode Agent 机制运行。

git clone https://github.com/zeekling/PuaSE.git

克隆到 OpenCode agents 目录后重启即可使用

查看完整指南 →

🤝 贡献

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

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