Sol Advisor 是一个面向 Codex / ChatGPT Desktop 原生插件与自定义子代理的“架构师编排工作流”。它将主会话定位为 Sol 架构师，负责任务拆解、架构设计、验收与最终判断；将实现工作路由给 Luna 或 Terra 两类实现代理；最后强制由新的 Sol reviewer 线程对真实 diff 和验证证据进行复审。项目本身主要由 Shell 脚本、Codex 插件配置、自定义 agent 模板和验证脚本组成，不是传统业务库或 Web 服务。
适用领域
AI 编程助手 / Codex 插件 / Agentic Engineering / 多代理软件开发流程 / 代码审查自动化 / AI 辅助架构设计 / 开发流程治理
配置难度
中高。对于熟悉 Codex CLI、Shell、AI agent 工作流和本地开发环境的高级用户，安装和使用难度可控；对于只使用普通 ChatGPT 聊天或不了解 Codex 插件体系的开发者，理解成本和环境配置成本较高。
商业价值
该项目的商业价值主要体现在提升 AI 辅助开发流程的可控性、可审计性和交付质量，而不是提供某个具体业务功能。对个人开发者，它可以减少 AI 生成代码未经复核直接合并的风险；对工程团队，它提供了一个可参考的多代理分工、强制验收、权限证据记录和最终审查机制。如果团队已经深度使用 Codex 进行日常开发，Sol Advisor 可以作为 AI 编程治理流程的基础模板；但如果团队没有 Codex 插件生态或指定模型权限，落地价值会明显受限。
01
技术亮点
- 工作流设计明确：Sol 负责架构和验收，Luna 负责常规实现，Terra 负责复杂实现，Sol reviewer 负责最终复审。
- 强调强制新上下文复审，可以减少同一对话中的假设污染和遗漏。
- 对 agent 文件安装采用保守策略：不静默覆盖用户已有角色，降低误配置风险。
- 提供 byte-for-byte 校验，确保本地 agent 模板与插件随附模板一致。
- 提供运行时 inspector，用于安全读取 allowlisted routing 字段，不输出 prompt、消息、环境变量、token 或任意 rollout 内容。
- 明确禁止静默 fallback：role、model、effort 缺失、不一致或不可观察时会停止相关 lane。
- 对只读 review 的权限边界有详细说明，能够报告 residual risk。
- 适合希望把 AI 编程从“聊天式生成”提升到“带验收门禁的工程流程”的用户。
- MIT 许可证，便于个人和团队二次使用。
02
目标用户
- 重度使用 Codex CLI 或 ChatGPT Desktop 进行代码开发的工程师
- 希望用 AI 子代理分工完成开发、审查和验收的团队
- 关注 AI 编程流程可控性、审计性和路由证据的高级开发者
- 负责设计 AI-assisted SDLC 工作流的架构师或技术负责人
- 愿意使用 GPT-5.6 Sol、Luna、Terra 等指定模型与推理等级的用户
03
配置要求
- 需要 Codex CLI 或 ChatGPT Desktop 支持 plugins、native subagents 和 custom agents。
- 需要可用的 GPT-5.6 Sol / High、GPT-5.6 Luna / Max、GPT-5.6 Terra / Max 配置。
- 需要安装 jq。
- 需要安装 companion custom-agent 文件；插件安装本身不会自动写入这些 agent 模板。
- 如果设置了 CODEX_HOME，安装器会使用 CODEX_HOME 下的 agents 目录；否则使用默认 Codex agents 目录。
- 安装器不会调用 Codex、不会修改 config.toml、不会覆盖已有且内容不同的 agent 文件。
- 每次安装或更新 agent 模板后都需要开启新的 Codex task。
- 运行时必须能观察 native spawn/details 元数据中的自定义 agent 类型；如果 model 或 effort 缺失，需要使用 inspect-agent-runtime.sh 从本地 rollout 中读取。
- Sol reviewer 的只读沙箱是请求型配置，最终是否强制只读取决于宿主环境实际权限策略。
04
适用场景
- 将一个功能需求拆解为明确的 objective、file ownership、interfaces、constraints 和 verification，再交由实现代理执行
- 根据任务复杂度自动或半自动选择 Luna 处理常规实现，选择 Terra 处理上下文复杂或高风险改动
- 在 AI 完成实现后强制进行独立上下文的 Sol 复审，降低主会话上下文偏差造成的误判
- 为 AI 子代理执行过程保留 role、model、effort、sandbox 等路由与权限证据
- 在团队内部建立更严格的 AI 编程交付流程：实现、验证、diff 检查、最终 reviewer ship 才能宣称完成
- 本地开发 Codex 插件、自定义 agent 模板和相关安装校验脚本
05
部署与配置
- 确认已安装当前版本的 Codex CLI 或支持插件、原生 subagents、自定义 agents 的 ChatGPT Desktop。
- 确认账号可以访问 GPT-5.6 Sol、GPT-5.6 Luna、GPT-5.6 Terra，并具备 README 要求的 reasoning level。
- 安装 jq，因为安装脚本会用它查询已安装插件路径。
- 添加 GitHub 仓库为 Codex marketplace：codex plugin marketplace add DannyMac180/sol-advisor --ref main
- 安装插件：codex plugin add sol-advisor@sol-advisor
- 定位插件目录：plugin_dir="$(codex plugin list --json | jq -r '.installed[] | select(.pluginId == "sol-advisor@sol-advisor") | .source.path')"
- 确认插件目录存在：test -n "$plugin_dir" && test -d "$plugin_dir"
- 安装 companion custom agents：sh "$plugin_dir/scripts/install-agents.sh"
- 校验已安装 agent 模板：sh "$plugin_dir/scripts/install-agents.sh" --check
- 校验通过后启动新的 Codex task，因为原生 agent 类型在任务创建时发现，旧任务可能无法识别新角色。
- 在主会话中选择 GPT-5.6 Sol / High reasoning，然后正常提出实现需求，或显式调用：Use $sol-advisor:orchestration to build this feature, verify it, and obtain the final Sol review before reporting done.
06
风险与注意事项
- 高度依赖 Codex/ChatGPT Desktop 的新插件、subagent 和 custom agent 能力，环境兼容性可能是主要障碍。
- README 中要求 GPT-5.6 Sol、Luna、Terra 等特定模型和推理等级；如果用户无访问权限，核心价值无法发挥。
- 项目主要是流程编排与脚本，并不直接提供通用代码生成模型或独立服务。
- 最终审查是 fresh context，但不是跨厂商、跨模型家族审查；仍可能继承同一模型生态的偏差。
- 只读 reviewer 依赖宿主权限策略，某些环境可能无法保证硬隔离。
- 安装和运行流程对普通开发者偏复杂，需要理解 Codex 插件、agents、sandbox、rollout metadata 等概念。
- 如果 Codex 平台 API、插件格式或 agent 机制变化，项目可能需要及时维护。
- 路由证据要求严格，任何元数据缺失或不一致都可能导致流程中断。
2026-08-08
第6名
新收录 · github_search
2026-08-07
第7名
新收录 · github_search
2026-08-06
第9名
新收录 · github_search
2026-08-05
第8名
新收录 · github_search
2026-08-04
第9名
新收录 · github_search
2026-08-03
第14名
新收录 · github_search
