Sol Advisor 是一个轻量、可扩展的 Shell 脚本工具，它不是另一个代码生成器，而是一套为 AI 编程设计的「角色化协作框架」——把大模型拆解成「架构师（Sol）」「执行者（Terra）」「独立评审员（Sol Reviewer）」三个明确角色，通过 Shell 工具链自动调度、隔离上下文、强制审查，解决当前 AI 编程中常见的「一问就写、写完就发、改错靠猜」等失控问题。它专为追求工程严谨性的开发者打造，在保持本地可控的前提下，让 Codex 类模型（如 GPT-5.6 系列）真正以「专业团队」方式协同交付软件能力。
核心功能
- 三角色分轨执行：自动启动三个逻辑分离的 AI 会话——Sol 主导需求分析与架构设计，Terra 专注按指令实现具体模块，Sol Reviewer 在无上下文污染下独立审查最终 diff 和验证证据，杜绝「自己写、自己审」的认知偏差
- 上下文强隔离机制：每个角色运行在独立的环境上下文中，Review 阶段严格禁用写权限并重置历史，确保评审基于真实变更而非记忆幻觉
- Codex 原生深度集成：针对 OpenAI Codex 模型族（特别是 GPT-5.6 Sol/Terra/High 版本）定制提示工程与会话协议，非通用 LLM 接口，强调能力路由与责任边界
- Shell 优先、零依赖部署：纯 Bash 实现，仅需 curl + jq + Python3（用于调用 API），无需 Docker、Node 或复杂运行时，开箱即用，适合嵌入 CI/CD 或本地开发流
- 能力导向的交付闭环：不以「生成多少行代码」为目标，而是围绕「能力（Capability）」组织工作流——从需求定义 → 架构分解 → 路由实施 → 验证归档，形成可追溯的交付证据链
- 可审计的决策日志：全程记录各角色输入/输出、调用参数、时间戳及人工干预点，支持回溯「为什么这样设计」「谁批准了哪段变更」，满足团队协作与合规要求
适合哪些人用
如果你是以下角色之一，Sol Advisor 会显著提升你的 AI 协作质量：
• 技术负责人 / 架构师：需要在引入 AI 的同时守住系统设计主权，避免模型越界决策；
• 资深工程师 / Tech Lead：希望用 AI 加速模块实现，但拒绝「黑盒提交」，坚持每处变更经独立验证；
• 开源项目维护者：面对 PR 提交时，亟需自动化初筛+结构化审查建议，降低人工评审负担；
• AI 工程教育者 / 研究者：探索「多智能体角色分工」在真实软件交付中的落地模式，该工具提供了可运行的最小实践范式。
快速上手
只需三步即可启动首个协作会话：
1. 克隆项目：git clone https://github.com/DannyMac180/sol-advisor.git && cd sol-advisor
2. 配置你的 OpenAI API Key（支持 .env 文件或环境变量）
3. 运行主命令：./sol-advisor.sh "实现一个带缓存的 HTTP 客户端，支持 GET/POST，超时 5s"
工具将自动唤起 Sol 架构师对话 → 分解任务 → 启动 Terra 实现 → 触发 Sol Reviewer 审查 → 输出带验证报告的完整 diff。所有交互均可在终端完成，无需 Web UI 或额外服务。
项目信息
Codex-native architect orchestration with Luna and Terra implementation lanes and mandatory fresh Sol review.
704
Stars
46
Forks
Shell
MIT
编程语言：Shell｜Star 数：704｜开源协议：MIT｜GitHub 项目地址
这不是又一个「AI 写代码」玩具，而是给认真做软件的人准备的 AI 协作操作系统——它把大模型从「万能实习生」变成「可信赖的跨职能团队」。
