Claude Code 很快，但你的代码质量跟上了吗？试试这个工程护栏

Claude Code 很快，但你的代码质量跟上了吗？

说实话，用 Claude Code 写项目，前半小时感觉自己在飞——代码哗哗出，功能一个接一个。但过一会儿就开始出问题：上下文丢了、测试没写、边界情况没考虑、代码风格飘忽……最后回头一看，产出的是”能跑的单文件 demo”，不是”能上线的生产级代码”。

这不是 Claude Code 的问题，是工作流的问题。

pilot-shell 解决的就是这件事。它不是又一个提示词包，而是一套给 Claude Code 和 Codex 加装的专业工程框架——把真正的工程师开发流程，固化成了 Claude 可以自动执行的规范。

它怎么工作的

pilot-shell 围绕三个核心命令构建了整个开发循环：

/spec — 把模糊的需求变成可验证的规格文档。先写清楚”这个功能要做什么、怎么做才算完成”，再动笔。

/prd — 从规划到验证的完整流水线。Brainstorm → Spec → 实现 → 测试 → 验证，每一步都有质量门禁（lint、类型检查、测试用例），不过关不放行。

/fix — Bugfix 专用通道，同样走 TDD 路线，复杂了就自动升级。

三个命令覆盖了功能开发、Bug 修复的全流程，而且全程强制 TDD——测试先写，代码后补，不存在”后面再补测试”这种自欺欺人的环节。

为什么这件事重要

AI 写代码的速度已经超过人类了，但”写完就算完”的心态也让大量 AI 生成代码停留在 demo 质量。

pilot-shell 的本质，是给 AI Coding 装上工程纪律的护栏。它解决三个核心问题：

上下文持久化 — Claude Code 有 context window 限制，满了会自动压缩。pilot-shell 在压缩前自动把项目状态、技术决策、当前进展存到持久记忆里，下一次 session 恢复时从断点继续，而不是从头开始。

质量门禁自动化 — lint / type check / 单元测试 / 文档存在性检查，全部在代码落地前强制执行。不是靠人肉 review，而是工具自动拦截。

团队上下文共享 — 规则、Skill、记忆都可以通过项目仓库同步给团队成员，新人加入直接继承项目的工程标准，不用每次重新约定。

实际体验是什么样的

安装只需要一行命令（macOS / Linux / WSL2）：

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

装完直接运行 claude，pilot-shell 自动加载，无需改任何配置。2 分钟装完，立刻生效。

在 pilot-shell 下开发一个功能，流程大概是：

1. /prd 描述需求 → 自动拆解成 spec 草稿
2. 审核/修改 spec，确认验收标准
3. TDD 模式：先写测试，AI 实现功能
4. 质量门禁自动跑：lint + type + test，任何一项失败阻断
5. 通过后，context 自动存档，session 结束也不丢

整个过程，开发者主要做决策和审核，机械的规范执行全部自动化。

谁应该用

如果你符合以下任意一条，pilot-shell 值得一试：

• 用 Claude Code 或 Codex CLI 做实际项目开发的工程师
• 团队里 AI Coding 产出质量参差不齐，缺乏统一工程标准
• 一个人维护多个并发项目，经常因为 context 丢失浪费大量重定向时间
• 想要 AI 辅助但不希望产出是”半成品代码”

作者是 maxritter，GitHub 1.8k stars，维护活跃（最近 2 天有更新）。支持 Claude Code 和 Codex CLI，跨平台覆盖 macOS / Linux / Windows (WSL2)。

快速安装

GitHub：https://github.com/maxritter/pilot-shell

一键安装：

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

说到底，AI Coding 的瓶颈从来不是”AI 能不能写”，而是”写的东西能不能用”。pilot-shell 给 Claude Code 加了一套工程护栏——不改变它的速度，但补上它最缺的纪律。

GitHub: https://github.com/maxritter/pilot-shell