pilot-shell

让 Claude Code 和 Codex 按工程规范干活，产出生产级代码

开源 🏷️定价信息待确认 ✅ 目前可打开 智能体 🍴 复刻 180 👀 关注 19
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 2122
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

pilot-shell 项目界面预览图
图片来源：项目官网

项目数据

分类智能体
开发团队maxritter
官网地址https://qualitylayer.dev
GitHubhttps://github.com/maxritter/qualitylayer
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议NOASSERTION
主要语言Shell
技术栈/模型agent-skills,agentic-engineering,ai-coding,claude-code,code-quality,code-review,codex,coding-agents,developer-tools,harness-engineering,human-in-the-loop,opencode,persistent-memory,pi,qualitylayer,software-engineering,spec-driven-development,tdd,team-collaboration,visual-planning
GitHub 星标★ 2122
上线时间2025-10-18 00:00:00
代码更新2026-11-08
仓库体积2.13 GB
本站数据更新2026-11-08
维护状态活跃
收录时间2026-08-09
浏览次数4

项目介绍

pilot-shell 是一个面向 Claude Code 和 Codex 的工程化智能体工作流框架，旨在解决 AI 编程助手在真实项目中难以稳定产出高质量代码的问题。它通过规范驱动的规划、强制测试驱动开发（TDD）、持久化记忆以及多层级质量检查，让 AI 编码代理具备生产级可靠性。核心能力包括：自动生成并执行规格说明、在编码前强制编写测试、跨会话保存项目上下文和决策记录，以及从语法到架构的多层质量门禁。项目采用 JavaScript 实现，深度集成 Anthropic Claude 和 OpenAI Codex 等主流编码代理，帮助开发团队将 AI 从“代码生成器”升级为“受控的工程协作者”，减少人工审查负担，提升交付一致性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2122

使用教程

难度：入门 约 2 分钟 部署方式：命令行工具 7 步

环境要求

  • macOS、Linux 或 Windows（需通过 WSL2）
  • 已安装并会使用 Claude Code 或 Codex CLI / ChatGPT 桌面端
  • 可访问 raw.githubusercontent.com 的网络环境
  • 具备 bash 与 curl，能执行管道命令

安装与启动步骤

  1. 1确认运行环境

    在 macOS/Linux 终端或 Windows 的 WSL2 中操作。Windows 原生终端不在支持范围内，安装会写入全局环境。

  2. 2安装 Pilot Shell

    执行官方安装脚本，全局安装，集成 Claude Code 与 Codex CLI 的内置概念（rules、hooks、skills、subagents、MCP）。

    curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

  3. 3启动 Claude Code

    安装完成后无需额外配置，直接在任意已有项目目录下运行 claude，Pilot Shell 会自动加载。

    claude

  4. 4启动 Codex 客户端

    使用 Codex CLI 时直接运行 codex；macOS 上也可重启 ChatGPT 桌面端并在其中打开项目。

    codex

  5. 5检查更新

    随时运行该命令检查是否有新版本，按提示升级即可。

    pilot update

  6. 6回退旧版本

    新版出现问题时，先指定 VERSION 环境变量，再重跑同一个安装脚本即可降级。版本号见 releases 页面。

    export VERSION=11.0.2
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

  7. 7卸载 Pilot Shell

    卸载会移除运行时、Console、状态栏、hooks、托管的 skills/rules/agents、MCP 条目等，保留 Claude Code、Codex 与项目文件。

    curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/uninstall.sh | bash

关键配置

配置项必填说明示例
VERSION否指定要安装/降级到的 Pilot Shell 版本号11.0.2

如何确认成功

安装后能直接运行 claude 或 codex 启动代理；执行 pilot update 能正常检查更新，即安装生效。

常见问题

Q：Windows 原生系统可以直接安装吗？

A：README 说明支持 macOS、Linux 和 Windows (WSL2)，因此 Windows 需要在 WSL2 环境中执行安装脚本，原生终端未列为支持环境。

Q：安装最新版后遇到 bug 想回退怎么办？

A：在 releases 页面找到目标版本号，先执行 export VERSION=11.0.2，再重新运行官方安装脚本即可回到该版本。

Q：如何彻底卸载？

A：运行 uninstall.sh 即可，交互式卸载会分别询问是否删除 Pilot 安装的外部工具、是否清除 Pilot 数据；也可用 --remove-tools 或 --purge-data 参数显式清理。

Q：卸载会删除我的项目或 Claude Code 吗？

A：不会。卸载只移除 Pilot 自己的运行时、hooks、托管技能规则、MCP 条目与别名，Claude Code、Codex、项目文件与用户数据都会保留。

注意事项

  • 安装是全局的，安装完成后在任意已有项目中运行 claude 或 codex 都会自动加载 Pilot Shell。
  • 安装脚本为 curl 管道执行方式，请确认访问的是官方 raw.githubusercontent.com 地址。
  • 降级时必须先 export VERSION 再执行同一条安装命令，否则仍会装最新版。
  • 安装过程中还会一并安装 Open Claude Design 与 Impeccable 等配套工具，如不需要可在卸载时单独选择清除。

核心亮点

  • 强制 TDD 流程，先写测试再实现，显著提升代码正确性
  • 持久化记忆跨会话保留项目上下文，减少重复沟通成本
  • 多层级质量检查覆盖语法到架构，拦截低级错误

不足之处

  • 文档/社区待观察
  • 依赖特定编码代理，迁移到其他工具需适配

适用场景

  • 团队引入 AI 编码助手但需保证代码质量的生产环境
  • 大型项目需要跨会话维护上下文和决策记录
  • 对测试覆盖率有严格要求的合规开发流程

替代项目

Claude Code、Codex、Aider

上一篇：HippocampAI

下一篇：jargo

同类项目推荐

deer-flow 开源

交给 AI 的大项目，能干几天几夜不撒手

An open-source long-horizon SuperAgent harness that researches, codes, and creates. ···

★ 85147 2026-08-09
Codex-Skills 开源

让 AI 前端开发更专业，从设计到交付一步到位

Codex-first Agent Skills library for premium frontend, website, motion, accessibilit···

★ 137 2026-08-09
git-mcp 开源

让 AI 直接读你 GitHub 代码，告别瞎编乱造

Put an end to code hallucinations! GitMCP is a free, open-source, remote MCP server ···

★ 8507 2026-08-09
LambChat 开源

让企业级 AI Agent 可管、可扩、可多租户落地

LambChat — Enterprise Agent Infra for governed AI agents. Skills + MCP powered, Loo···

★ 223 2026-10-08
openyak 开源

本地优先的桌面 AI 编程助手，无需账号，隐私无忧

One chat. Every agent. A universal interface for AI agents running on your computer.

★ 694 2026-08-09
kasetto 开源

用声明式配置统一管理 AI 编程助手环境，一处配置，处处生效。

Declarative AI agent environment manager, written in Rust

★ 216 2026-08-09
Claude-Code-Game-Master 开源

把任何书变成你的RPG冒险世界，用Claude Code玩出沉浸剧情。

Total conversion for Claude Code. Use RAG and the RPG ruleset apis to play a persist···

★ 161 2026-08-09
okf-skills 开源

让 Claude Code 轻松创建、校验和可视化结构化知识包。

The OKF toolkit for Claude Code — author, maintain, validate & visualize Open Knowl···

★ 444 2026-08-09