Pilot Shell
为 Claude Code 与 Codex CLI 加入规格驱动开发、TDD 和质量门禁。
按维度查看评分与理由
证据显示安装脚本会修改用户配置目录（~/.claude, ~/.codex, ~/.pilot），并安装多个第三方依赖（Semble, RTK, CodeGraph, Chrome DevTools MCP, playwright-cli, agent-browser），但未明确说明权限最小化原则。用户确认方面，/spec 和 /build 工作流有明确的审批门（Plan Approval），/fix 无审批但设计为快速修复。数据流透明度不足，未详细说明数据如何被收集、存储和共享。敏感数据处理方面，提到许可证密钥和配置备份，但未说明加密存储。依赖安全性方面，pyproject.toml 列出了依赖但未提供漏洞扫描或锁定文件。外部影响方面，安装会修改 shell 配置和全局配置，但提供了卸载脚本。回滚方面，安装器有回滚机制，且提供降级和重置选项。来源归属方面，许可证明确版权归 Max Ritter，但发布者未验证。
自洽性方面，README 描述的工作流与 pyproject.toml 中的测试配置一致，但部分文件被 git-crypt 加密，无法验证。依赖可用性方面，依赖列表明确，但未提供锁定文件或镜像。失败消息方面，安装器有错误处理，但未提供详细日志。
受众和场景方面，README 明确面向使用 Claude Code 和 Codex CLI 的开发者，提供了多种工作流。能力边界方面，/fix 明确限制在单文件 bug，/spec 和 /build 有明确的范围。触发精度方面，命令触发明确，但未提供详细的触发条件文档。环境适配方面，支持 macOS、Linux、Windows (WSL2)，并提供了 Dev Container 支持。
信息架构方面，README 结构清晰，有目录和链接。安装说明详细，包括先决条件和步骤。命名稳定性方面，命令名称稳定，但未提供命名规范文档。示例和 FAQ 方面，提供了命令示例，但缺少 FAQ。已知限制方面，未明确列出。许可证方面，提供了自定义许可证，但非标准开源许可证。版本和变更日志方面，pyproject.toml 有版本号，但未提供 CHANGELOG 文件。维护责任方面，版权归 Max Ritter，但未明确维护者。
输出可用性方面，工作流生成 PRD、spec、buildout 等文件，格式明确。边际价值方面，提供了 TDD 强制、质量门禁等独特功能。成本效益方面，声称 60-90% 成本降低，但未提供具体数据。
声明可追溯性方面，README 中的功能描述未提供具体实现细节。跨来源佐证方面，未提供第三方验证。事实与推断分离方面，README 中的性能声明未区分事实和推断。
- 安装脚本会修改用户配置目录和安装多个第三方依赖，建议在隔离环境中测试。
- 部分源代码文件被 git-crypt 加密，无法进行完整的安全审计。
- 许可证为自定义许可证，非标准开源许可证，使用前需仔细阅读条款。
- 发布者身份未验证，建议谨慎对待。
这个 Agent 能做什么，适合哪些场景？
Pilot Shell 是安装在本机的开发工作流层，面向 Claude Code 和 Codex CLI 提供从需求到验证的结构化流程。它以 /prd、/spec 和 /fix 分别处理需求澄清、功能或架构工作，以及小范围缺陷修复，并在流程中强调测试驱动开发和质量检查。安装程序会部署规则、技能、审查代理、hooks、MCP 配置和 Console 相关文件；Claude Code 获得完整功能覆盖，Codex CLI 可运行全部工作流但部分平台功能较少。其本地 Console 运行在 localhost:41777，用于查看规格、需求、会话、记忆、扩展、变更和使用情况。它并非独立编码模型或托管代码服务，而是依赖已安装的 Claude Code 或 Codex CLI，并把项目规则和自动化工具接入这些客户端。
先通过 /setup-rules 读取代码库中的现有规则、CLAUDE.md、AGENTS.md 和代码模式，生成模块化项目规则并可记录可用 MCP 服务。/prd 将模糊想法经讨论、澄清与可选研究写入 docs/prd/；/spec 进行代码库探索、提问和规格编写，等待批准后在隔离 git worktree 中按 RED→GREEN→REFACTOR 实现，运行质量 hooks、测试、变更审查和 UI 场景的浏览器自动化验证。/fix 则复现问题、通过 codegraph_context 与 semble search 定位根因、先写失败测试，再做最小修复并执行端到端、lint、类型、构建及回归检查。它还安装 Semble、RTK、CodeGraph、Chrome DevTools MCP、playwright-cli 和 agent-browser 等依赖，并由 Console 展示流程产物与通知。
- 使用 Claude Code 的独立开发者，希望把一项 OAuth/JWT 认证功能先写成可审批规格，再在隔离 worktree 中按 TDD 实现和验证。
- 使用 Codex CLI 的团队成员，需要运行 $setup-rules，让工具从既有代码库归纳约定并维护项目级上下文。
- 维护本地项目的工程师，遇到可明确定位的单文件缺陷时，希望用 /fix 先建立失败测试，再以实际程序执行作为主要正确性证据。
- 需要在评审前收集同事意见的产品与工程团队，可用 Console 查看 /prd 和 /spec 产物，并对需求或规格添加注释。
- 希望比较规则或技能是否真的改善输出的团队，可用 /benchmark 在隔离沙箱中运行带目标与不带目标的提示并查看断言差异。
这个 Agent 有哪些优点和局限？
- 将需求、规划、批准、TDD 实现、验证和审查组织为明确的 /prd、/spec、/fix 工作流，而非只提供通用提示。
- /spec 在隔离 git worktree 中实施，并把质量 hooks、全量测试、变更审查及 UI 浏览器场景验证纳入流程。
- /setup-rules 可基于代码库、既有规则与上下文文件生成模块化规则，并可同步到 AGENTS.md。
- Console 在 localhost:41777 集中呈现规格、需求、记忆、会话、扩展和 Git 变更，并支持规格与需求注释。
- 必须先安装并订阅 Claude Code 或 Codex CLI；它不会安装这两个客户端本身。
- Codex CLI 虽支持全部工作流，但文档明确说明其平台功能少于 Claude Code。
- 安装会写入用户级 ~/.pilot、Claude 配置目录和/或 ~/.codex、~/.agents 等位置，并安装多项工具，采用前应评估本机配置影响。
- 部分能力依赖网络、MCP、浏览器自动化、Semble、RTK 与 CodeGraph 等外部组件；文档未说明离线或最小依赖模式。
- 仓库列出的许可证标识为 NOASSERTION，README 仅指向 LICENSE 文件，所给资料未明确许可条款。
如何安装或部署这个 Agent？
先自行安装至少一个受支持的客户端：Claude Code 或 Codex CLI，并具备相应订阅；Claude Code 为主要集成，Codex CLI 支持全部工作流但平台功能较少。支持 macOS、Linux 和 Windows WSL2。随后在终端运行：
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash安装器会检查或安装 Homebrew、Node.js、Python 3.12+、uv、git 和 jq，并在检测到相应客户端时写入其配置。安装后直接运行 claude 或 codex。
如何使用这个 Agent？
进入目标项目后启动 claude 或 codex，并先执行一次项目规则初始化：Claude Code 使用 /setup-rules，Codex CLI 使用 $setup-rules。需求尚不清晰时使用 /prd "..."（Codex 为 $prd "..."）；需要功能、重构或架构规划时使用 /spec "..."（Codex 为 $spec "..."）；局部缺陷使用 /fix "..."（Codex 为 $fix "..."）。/spec 会在规划后等待批准，再进入实现和验证；若 /fix 发现问题跨多个组件或属于架构性问题，会要求改用 /spec。
这个 Agent 与同类方案有什么区别？
Pilot Shell 将 Claude Code 作为主要集成并提供完整功能覆盖；Codex CLI 可使用全部工作流，但平台功能较少。它定位为在两者已有 rules、hooks、skills、subagents 和 MCP 概念之上增加工作流与质量控制，而不是替代这两个 CLI。