maxritter/pilot-shell
How real engineers run Claude Code and Codex: spec-driven planning, enforced TDD, persistent memory, and quality enforcement on all levels. Make your agents production-ready.
Pilot Shell – 为 Claude Code 与 Codex 增强的 AI 命令行工具
是什么 – 一个轻量级的 Shell/CLI，位于 Anthropic 的 Claude Code（主）或 OpenAI 的 Codex 之上，添加了结构化、测试驱动的开发工作流。它将原始的代码生成提示转化为可重复、经过质量检查的流水线，涵盖需求收集、规格制定、实现、缺陷修复和自主构建。
为何存在 – Claude Code 和 Codex 能快速编写代码，但缺乏框架时会：
- 跳过测试和 linting，
- 会话间丢失上下文，
- 产生不一致的结果。 Pilot Shell 注入了 规格驱动 和 目标驱动 的流程、质量门禁以及持久的“记忆”，使 AI 行为更像一位有纪律的工程团队成员。
核心概念与命令
| 命令 | 使用时机 | 功能 |
|---|---|---|
/prd |
你有一个模糊的想法或问题陈述时。 | 进行头脑风暴，可选地进行网络调研，并生成一份产品需求文档（PRD），保存在 docs/prd/ 下。 |
/spec |
你有一个明确的功能或 bug 要处理时。 | 引导 AI 完成 计划 → 审核 → 实现（TDD）→ 验证 → 完成 流程，自动执行 lint/format/type 检查，并支持可选的协作式规格审查。 |
/build |
你想在没有完整规格的情况下达成具体目标时。 | 生成简短的任务列表 + 接受标准，然后迭代构建、评估并优化，直到标准通过。 |
/fix |
你需要一个符合测试驱动流程的 bug 修复时。 | 执行聚焦的 TDD 循环；若修复过于复杂则中止。 |
pilot（管理员别名） |
管理安装、更新和配置。 | 安装/卸载运行时，激活许可证，切换模型等。 |
主要功能
- 质量钩子 – 每次编辑都会自动强制执行 linting、格式化、类型检查和测试执行。
- 上下文工程与记忆共享 – 决策、规则和“记忆”会持久化存储在
~/.pilot/，并可通过项目仓库共享。 - 语义搜索（Semble）+ 代码知识图谱（CodeGraph） – 快速准确的代码库查找，减少 token 使用量。
- 令牌优化 – 通过 RTK 压缩和 Semble 搜索，实现 60–90% 的成本降低。
- Pilot Bot – 持久的后台代理，可运行定时任务或长时间运行的任务。
- 扩展 – 可重用的规则、技能和 MCP（消息-控制-协议）服务器，团队可共享。
- 控制台 – 本地 Web 仪表板，实时显示通知、会话日志和当前需求/规格。
安装（快速入门）
# 一行命令适用于 macOS、Linux 和 Windows（WSL2）
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash
安装程序：
- 检查 Homebrew、Node、Python 3.12+、git、jq 是否存在。
- 检测支持的 AI 代理（Claude Code 或 Codex）——你必须提前安装其中之一。
- 将 Pilot 资产部署到
~/.pilot/并安装代理专用适配器。 - 安装支持工具（Semble、RTK、CodeGraph、Playwright、Chrome-DevTools MCP、语言服务器等）。
- 为 bash、fish 和 zsh 添加 shell 别名（
pilot、claude/codex包装器）。
要卸载但保留数据：
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/uninstall.sh | bash
添加 --purge-data 以删除 ~/.pilot/。
先决条件
- Claude Code – 原生安装程序（需要 Anthropic 订阅）或
- Codex CLI / ChatGPT 桌面版（需要 OpenAI 订阅）。
- 现代终端（推荐 Zentty，但 iTerm2、Ghostty 等也可用）。
典型工作流示例
# 启动 Claude Code（或 Codex）
claude # 或：codex
# 1️⃣ 创建 PRD
> /prd "为团队更新添加实时通知"
# 2️⃣ 转换为规格并实现
> /spec "为团队更新添加实时通知"
# – Pilot 将引导你完成规划、编写端到端测试、使用 TDD 实现、验证并合并。
# 3️⃣ 后续需要快速修复时
> /fix "页面刷新后通知停止"
所有步骤均被记录，生成的规格、规则和记忆将保留在仓库中以供未来复用。
哪些人可能受益？
- 已使用 Claude Code 或 Codex 但希望获得有纪律、可重复工作流的软件工程师。
- 需要共享规格、质量门禁，并在团队成员间持久化 AI 生成知识的团队。
- 希望在降低 token 成本的同时保持 AI 辅助安全且测试驱动的独立开发者。
链接
- 文档： https://pilot-shell.com/docs
- 博客： https://pilot-shell.com/blog
- 发布： https://github.com/maxritter/pilot-shell/releases
- 许可证与激活：
pilot activate <key>（从 Pilot 成员区获取密钥）
相关
- 项目
- 项目
- 项目
- Dispatch
- 项目