Pilot Shell
为 Claude Code 与 Codex CLI 加入规格驱动开发、TDD 和质量门禁。
这个 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。