Platform Adapters

跨平台接入

Roundtable v1.3.2 是核心协议包 + 三个平台薄入口。Codex、Claude Code 和 Trae 都指向同一个 roundtable/SKILL.md，避免协议分叉。

原生适配度最高

Codex

Entry

roundtable/codex/AGENTS-snippet.md

Install

加入项目 AGENTS.md，或将整个 roundtable/ 安装为 Codex skill。

Risk

如果 AGENTS.md 未引用，Codex 不一定自动触发 Roundtable。

适合项目规则 + slash command

Claude Code

Entry

roundtable/claude/CLAUDE-snippet.md + roundtable/claude/commands/roundtable.md

Install

把 snippet 加到 CLAUDE.md；如支持命令文件，把 command 复制到 .claude/commands/roundtable.md。

Risk

不同 Claude Code 环境对 command 文件支持可能不同，CLAUDE.md snippet 是兜底。

适合 Project Rules + Custom Agent

Trae

Entry

roundtable/trae/project_rules.md + roundtable/trae/custom-agent-prompt.md

Install

把 project_rules.md 放入 Trae Project Rules，并用 custom-agent-prompt.md 创建专用 Agent。

Risk

Trae rules 遵循可能不稳定，因此 custom agent prompt 和 validator 必须作为兜底。

统一安装策略

平台文件只负责触发、导读和校验命令；协议、schema、模板和脚本只维护一份。agent registry 优先读取 AGENCY_AGENTS_HOME。

  • 核心协议只维护 roundtable/SKILL.md 和 references/。
  • 平台入口不得复制完整协议正文。
  • 新产物中的专家引用统一使用 agency://<agent-id>。
  • agency-agents 路径优先从 AGENCY_AGENTS_HOME 读取，再回退到 $HOME/agency-agents。
  • execution-review.md 只有 execution_result_state = executed_reviewed 才能生成。
  • runtime 不可用时记录 execution_adapter_status = unavailable 与 execution_result_state = not_executed。
  • 归档完成前运行 validate-json.mjs。
Agent Registry 解析

v1.3.2 保持 agency-agents 作为 source of truth，并允许不同运行时用环境变量指向实际安装目录；CodeGraph 仅作为可选代码库证据适配器。

bash
export AGENCY_AGENTS_HOME=/Volumes/Work/agency-agents

node roundtable/scripts/new-archive.mjs --topic feedback-platform --prototype pencil
node roundtable/scripts/validate-json.mjs docs/roundtable/2026-05-19_feedback-platform
node roundtable/scripts/validate-execution-context.mjs docs/roundtable/2026-05-19_feedback-platform/execution-context.json
统一校验

所有平台最后都回到同一套脚本校验 JSON、artifact_refs、acceptance_refs 和 execution-review 状态规则。