核心原则

功能介绍

👥 Agent 评审流程，而非人工三角色串行审核

v1.8.5 的默认目标仍是接在需求分析之后，用 registry-backed 多 Agent 圆桌替代繁琐的人工多角色审核，并把结果写成机器可读契约：

议题类型推荐专家
默认核心席位产品专家、架构师、开发工程师、QA；高风险时自动补安全、数据、SRE 或项目管理专家
评审输入需求分析结果、context-pack、证据索引、已知约束、风险候选和验收标准
评审输出review-result.json：continue、needs_human_review、blocked，以及带 agent_ref / review_mode / source metadata 的 agent_opinions
生成模式roundtable review <input> 自动生成 context-pack、review-result、decisions、tasks、validation-plan、report
升级条件证据不足、专家冲突、高风险动作、不可逆数据影响、安全/合规风险或验收路径不可验证

🎯 证据优先，而非观点优先

每个专家结论必须标注证据类型：

证据等级说明
A已运行命令、测试、扫描、代码读取或真实数据验证
B基于项目文件、接口定义、配置和依赖推导
C基于通用经验判断
D信息不足下的降级分析

👥 动态圆桌，而非固定全员会议

核心专家来自 agency-agents 注册表；v1.8.5 优先通过 AGENCY_AGENTS_HOME 定位注册表，兼容 .agents 与旧运行时目录，并按 complexity_level 决定 Mini、Standard 或 Full 圆桌：

议题类型推荐专家
简单 UI 或文案调整产品专家、开发工程师、QA
Prototype / Pencil 原型交付产品专家、架构师、数据专家、开发工程师
数据模型或迁移数据专家、架构师、QA、安全专家
登录、权限、支付安全专家、架构师、开发工程师、QA
部署、监控、稳定性SRE、QA、安全专家、项目管理专家
架构重构、权限、支付、审批等高风险代码路径架构师、安全专家、开发工程师、QA；建议启用 CodeGraph evidence adapter
可访问性、API、性能、模型质量等专业风险从 agency-agents 动态召回 1-4 位专门专家
registry 不可直接执行读取 Agent markdown 作为 brief_only；缺失时显式记录 fallback / degraded_reason
复杂实施或多阶段执行开发工程师、QA、项目管理专家；执行层可启用 Superpowers
大型架构变更全员圆桌

需求模糊

客户反馈平台

把“做个平台”这种方向性表达，收敛成 MVP 页面、数据模型、权限边界和验收标准。

AI / 自动化

AI 客服辅助

把“接 AI”拆成能力边界、知识库范围、人工确认机制和风险控制要求。

架构与重构

系统重构

把“重构一下”这种高风险口号拆成边界、阶段计划、回滚策略和验证指标。

原型 / Pencil

Prototype / Pencil 原型交付

把“先出原型”变成清晰页面、数据模型、权限规则和可验收 Prototype Handoff。

🛡️ 高风险动作必须人工确认

动作类型与默认策略：

动作类型默认策略
读取文件、生成报告、生成图表可自动执行
运行测试、构建、lint、安全扫描可自动执行，记录命令和结果
安装依赖、修改代码、数据库迁移、提交代码必须人工确认
删除文件、重置分支、修改生产配置默认禁止

🎨 Design Intelligence 是增强层，而非决策源

当任务涉及官网、产品界面、原型设计或前端体验时，可启用 ui-ux-pro-max-skill 增强设计表达：

动作类型默认策略
可增强Design Direction、Pencil Prompt、前端设计 brief、UI/UX review checklist
不可修改Product Goal、页面业务范围、Data Model、API Contract、Permission Rules
默认策略可选启用；非 UI 任务不默认生成设计增强产物

⚡ CodeGraph 是证据适配器，而非决策源

当任务涉及大型仓库、架构重构或高风险代码路径时，可用 CodeGraph 增强 context-pack 证据，但决策仍由圆桌协议产物负责：

动作类型默认策略
可增强符号关系、调用图、路由入口、依赖关系、影响半径摘要
不可修改decisions.json、tasks.json、prototype-handoff.md、execution_result_state
默认策略默认关闭；在 --scan、--full、架构重构、高风险实施前建议启用
归档策略只引用或摘要 .codegraph/ 索引，不默认复制索引进 Roundtable archive

⚡ Superpowers 是执行层，而非决策源

v1.8.5 继续将 Superpowers 作为独立执行适配器，并用 execution_result_state 明确区分计划、执行和复盘：

动作类型默认策略
可增强execution_method_selection、execution-context.json、execution-plan.md、execution-log.md；只有 executed_reviewed 才生成 execution-review.md
不可修改decisions.json 裁决语义、业务范围、权限规则、验收标准、人工确认规则
动态策略light 不自动启用；mini 条件建议；standard/full 实施流默认启用；full 必须记录执行方法选择
三态约束not_executed、executed_unverified、executed_reviewed；静态计划不得伪造成执行复盘
显式控制--execute-with superpowers 启用；--no-superpowers 禁用并记录原因

✅ 质量门禁是协议完整度的一部分

v1.8.5 把协议完整度推进到可接入、可解释、可回归：Agent 来源、评审意见、人工复核路由、fallback 退化、项目接入指南和 benchmark 都必须可复核：

动作类型默认策略
结构校验validate-json.mjs 校验核心 JSON、artifact_refs、acceptance_refs、schema 引用和执行状态约束
质量校验quality-check.mjs 覆盖 Q-001 到 Q-030，包括证据、风险、审批、版本、归档完整度和 Agent Review 结果契约
评审契约Q-021 到 Q-025 校验 review-result.json、人工复核角色、blocked 理由、continue 安全性和核心角色意见
Agent 来源契约Q-026 到 Q-030 校验 active_agents 覆盖、agent_ref、brief_only 来源、人工复核路由和 fallback 退化行为
基准回归benchmark 场景覆盖生成式评审、Agent fallback、markdown 兼容、安全升级、专家路由、CodeGraph 证据接入和通用工作流网关
项目接入integration-guide 说明工作流门禁位置、Agent registry 配置、review-result 映射和执行前验证步骤
接入自诊断roundtable doctor 检查版本、必需文件、Agent registry、核心角色、示例归档、质量和 benchmark 就绪状态
发布完整性check-version、node --test 和 npm run ci 确保 manifest、package、SKILL、脚本和发布文件清单保持一致
默认结论低于质量阈值不得伪装成完整圆桌结论，必须标注缺口或进入人工复核

🧩 平台适配是薄入口，而非协议分叉

Codex、Claude Code 和 Trae 都指向同一个 roundtable/SKILL.md，平台层只负责触发、导读、agent registry 路径解析和校验命令：

动作类型默认策略
Codexcodex/AGENTS-snippet.md + SKILL.md，适合原生 skill / AGENTS 工作流
Claude Codeclaude/CLAUDE-snippet.md + claude/commands/roundtable.md，适合项目规则和 slash command
Traetrae/project_rules.md + trae/custom-agent-prompt.md，规则较短，脚本校验兜底
Agent RegistryAGENCY_AGENTS_HOME -> $HOME/agency-agents -> .agents -> $HOME/.claude/agents compat
统一校验validate-json.mjs 检查 artifact_refs、acceptance_refs 和 execution-review 状态约束