Pilot Shell 架构全景拆解规则、钩子、技能与MCP如何协同工作【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shellPilot Shell 是一套面向Claude Code 与 OpenAI Codex的专业上下文工程Context Engineering与测试框架系统它通过规则Rules、钩子Hooks、技能Skills与 MCP 服务器四大支柱把规格驱动开发、TDD、持久化记忆、质量门禁和端到端验证组织成一个完整的工程闭环帮助新手也能像职业工程师一样驾驭 AI 编程代理。一张图看懂 Pilot Shell 的架构分层Pilot Shell 的核心理念是规则和记忆只是上下文供给真正的产品是协调整个工程流程的框架。四个支柱各司其职支柱目录职责生效时机 规则 Rulespilot/rules/语言标准、测试策略、验证要求会话启动 / 文件类型相关时 钩子 Hookspilot/hooks/质量门禁、上下文恢复、记忆同步会话生命周期的每个节点 技能 Skillspilot/skills//spec、/build、/fix、/prd 等结构化工作流用户显式调用 MCP 服务器pilot/.mcp.json代码检索、持久记忆、库文档等外部能力会话中按需懒加载规则8 条常驻 9 条按路径触发的工程标准规则是每次会话都成立的共识。Pilot 内置 17 个模块化规则文件分为三类核心框架3 条任务与工作流程、按风险定级的测试策略、与受影响的命令/UI 相匹配的验证证据verification.md开发实践3 条系统化调试、Git 规则、如何接收 Code Review 反馈code-review-reception.md工具与上下文4 条CLI 工具选型、浏览器自动化、MCP 服务器参考mcp-servers.md语言标准Python、TypeScript、Go、.NET 等 9 个是路径门控的——只有当相关文件出现在工作中时才加载避免挤占宝贵的上下文窗口。在任意项目中运行/setup-rules还能从真实代码库生成项目专属规则。 对新手的关键收益你不需要自己写 CLAUDE.md 规则Pilot 直接把生产环境验证过的最佳实践加载进每个会话。钩子在会话生命线的每个节点自动执法钩子是整个框架的强制执行层。所有钩子统一注册在 pilot/hooks/hooks.json并有一份可测试的生命周期清单保证声明与实际文件一致。核心节点一览生命周期事件典型钩子做什么SessionStartcodegraph_init.py、licensed_assets_sync.py初始化代码图谱、同步技能资产、异步同步记忆UserPromptSubmitspec_mode_guard.py检查工作流状态防止非法进入实现阶段PreToolUse/PostToolUsefile_checker.py、context_monitor.py文件写入后即时检查、监控上下文用量PreCompact/compactpre_compact.py、post_compact_restore.py压缩前抢救状态、压缩后恢复关键上下文Stopspec_stop_guard.py停止守卫义务未完成时代理不能看起来做完了就收工SessionEndsession_end.py会话收尾、记忆落盘其中最体现职业工程师气质的是Stop 守卫spec_stop_guard.py在 TDD 循环、独立评审和运行时验证全部通过之前工作流不会被允许关闭从机制上杜绝了假装完成的交付。技能把结构化工作流做成可编排的步骤包技能Skills是显式调用的工作流引擎每个技能都是一个编排器 步骤文件的结构。以/spec工作流为例它的manifest.json声明了编排器与执行步骤而计划阶段技能 spec-plan 则把生成计划拆成了 13 个细粒度步骤从工作区扫描到端到端场景设计再到计划审批每一步都有明确的输入输出契约。四大结构化工作流的选择逻辑/spec— 任务需要先出方案再实现计划 → TDD → 独立评审 → 端到端验证/build— 目标明确但任务清单需要边做边长验收标准驱动的多轮构建/fix— 行为坏了复现 → RED 测试 → 根因修复 → 质量门禁 → 审计/prd— 问题或范围还没想清楚探索方向并产出可评审的需求文档MCP七个懒加载服务器给代理装上外置大脑MCP 配置文件预置了 7 个服务器全部懒加载——按关键词发现后再调用保持上下文精简服务器解决什么问题CodeGraph结构问题符号、调用者/被调用者、影响半径一次调用返回源码 调用路径Semble意图问题X 功能在哪里改的、跨语言概念检索mem-search历史问题过去的决策与上下文持久记忆context7库/框架的最新官方文档web-search / web-fetch网络检索与完整页面抓取grep-mcp公共仓库中的真实代码参照规则文件 mcp-servers.md 还教代理什么时候该用哪个——例如已知文件路径就直接读文件不要绕道图谱查询这种比例原则Proportionality正是上下文工程的精髓。协同全景一次 /spec 请求的完整旅程把四层串起来一次典型请求的流转是这样的用户输入 /spec 实现 X 功能 │ ├─ 钩子 UserPromptSubmitspec_mode_guard 校验进入状态 ├─ 技能 spec-plan 编排扫描工作区 → 探索MCP: CodeGraph/Semble │ → 写计划 → 用户审批Console 可批注 ├─ 规则 testing.md按风险决定测试深度 ├─ 技能 spec-implementTDD 循环file_checker 钩子逐次校验 ├─ 钩子 Stopspec_stop_guard 拦截未完成即停止 └─ 验证通过后mem-search 记忆落盘Console 记录验证证据而人类控制平面由本地 Consolelocalhost:41777承担审阅与批注需求和 Diff、恢复会话、查看进度与成本。所有支柱的状态在这里变成可点击、可检索的界面。快速上手两步接入你的项目git clone https://gitcode.com/GitHub_Trending/cl/pilot-shell cd pilot-shell bash install.sh安装器是幂等的 8 步流程失败自动回滚会自动为 Claude Code 与 Codex 分别适配资产。装完后直接运行claude或codex即可框架自动生效。小结为什么说这是框架而不是配置合集规则供给共识MCP供给上下文技能供给流程钩子供给强制力——四者缺一个闭环就断了停止守卫与独立评审把看起来完成变成有证据的完成上下文在压缩与长任务中可恢复、跨 Claude Code 与 Codex 持久共享更多细节可参考仓库内的官方文档Hooks 管线、规则与标准、MCP 服务器与知识系统。【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Pilot Shell 架构全景拆解：规则、钩子、技能与MCP如何协同工作
Pilot Shell 架构全景拆解规则、钩子、技能与MCP如何协同工作【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shellPilot Shell 是一套面向Claude Code 与 OpenAI Codex的专业上下文工程Context Engineering与测试框架系统它通过规则Rules、钩子Hooks、技能Skills与 MCP 服务器四大支柱把规格驱动开发、TDD、持久化记忆、质量门禁和端到端验证组织成一个完整的工程闭环帮助新手也能像职业工程师一样驾驭 AI 编程代理。一张图看懂 Pilot Shell 的架构分层Pilot Shell 的核心理念是规则和记忆只是上下文供给真正的产品是协调整个工程流程的框架。四个支柱各司其职支柱目录职责生效时机 规则 Rulespilot/rules/语言标准、测试策略、验证要求会话启动 / 文件类型相关时 钩子 Hookspilot/hooks/质量门禁、上下文恢复、记忆同步会话生命周期的每个节点 技能 Skillspilot/skills//spec、/build、/fix、/prd 等结构化工作流用户显式调用 MCP 服务器pilot/.mcp.json代码检索、持久记忆、库文档等外部能力会话中按需懒加载规则8 条常驻 9 条按路径触发的工程标准规则是每次会话都成立的共识。Pilot 内置 17 个模块化规则文件分为三类核心框架3 条任务与工作流程、按风险定级的测试策略、与受影响的命令/UI 相匹配的验证证据verification.md开发实践3 条系统化调试、Git 规则、如何接收 Code Review 反馈code-review-reception.md工具与上下文4 条CLI 工具选型、浏览器自动化、MCP 服务器参考mcp-servers.md语言标准Python、TypeScript、Go、.NET 等 9 个是路径门控的——只有当相关文件出现在工作中时才加载避免挤占宝贵的上下文窗口。在任意项目中运行/setup-rules还能从真实代码库生成项目专属规则。 对新手的关键收益你不需要自己写 CLAUDE.md 规则Pilot 直接把生产环境验证过的最佳实践加载进每个会话。钩子在会话生命线的每个节点自动执法钩子是整个框架的强制执行层。所有钩子统一注册在 pilot/hooks/hooks.json并有一份可测试的生命周期清单保证声明与实际文件一致。核心节点一览生命周期事件典型钩子做什么SessionStartcodegraph_init.py、licensed_assets_sync.py初始化代码图谱、同步技能资产、异步同步记忆UserPromptSubmitspec_mode_guard.py检查工作流状态防止非法进入实现阶段PreToolUse/PostToolUsefile_checker.py、context_monitor.py文件写入后即时检查、监控上下文用量PreCompact/compactpre_compact.py、post_compact_restore.py压缩前抢救状态、压缩后恢复关键上下文Stopspec_stop_guard.py停止守卫义务未完成时代理不能看起来做完了就收工SessionEndsession_end.py会话收尾、记忆落盘其中最体现职业工程师气质的是Stop 守卫spec_stop_guard.py在 TDD 循环、独立评审和运行时验证全部通过之前工作流不会被允许关闭从机制上杜绝了假装完成的交付。技能把结构化工作流做成可编排的步骤包技能Skills是显式调用的工作流引擎每个技能都是一个编排器 步骤文件的结构。以/spec工作流为例它的manifest.json声明了编排器与执行步骤而计划阶段技能 spec-plan 则把生成计划拆成了 13 个细粒度步骤从工作区扫描到端到端场景设计再到计划审批每一步都有明确的输入输出契约。四大结构化工作流的选择逻辑/spec— 任务需要先出方案再实现计划 → TDD → 独立评审 → 端到端验证/build— 目标明确但任务清单需要边做边长验收标准驱动的多轮构建/fix— 行为坏了复现 → RED 测试 → 根因修复 → 质量门禁 → 审计/prd— 问题或范围还没想清楚探索方向并产出可评审的需求文档MCP七个懒加载服务器给代理装上外置大脑MCP 配置文件预置了 7 个服务器全部懒加载——按关键词发现后再调用保持上下文精简服务器解决什么问题CodeGraph结构问题符号、调用者/被调用者、影响半径一次调用返回源码 调用路径Semble意图问题X 功能在哪里改的、跨语言概念检索mem-search历史问题过去的决策与上下文持久记忆context7库/框架的最新官方文档web-search / web-fetch网络检索与完整页面抓取grep-mcp公共仓库中的真实代码参照规则文件 mcp-servers.md 还教代理什么时候该用哪个——例如已知文件路径就直接读文件不要绕道图谱查询这种比例原则Proportionality正是上下文工程的精髓。协同全景一次 /spec 请求的完整旅程把四层串起来一次典型请求的流转是这样的用户输入 /spec 实现 X 功能 │ ├─ 钩子 UserPromptSubmitspec_mode_guard 校验进入状态 ├─ 技能 spec-plan 编排扫描工作区 → 探索MCP: CodeGraph/Semble │ → 写计划 → 用户审批Console 可批注 ├─ 规则 testing.md按风险决定测试深度 ├─ 技能 spec-implementTDD 循环file_checker 钩子逐次校验 ├─ 钩子 Stopspec_stop_guard 拦截未完成即停止 └─ 验证通过后mem-search 记忆落盘Console 记录验证证据而人类控制平面由本地 Consolelocalhost:41777承担审阅与批注需求和 Diff、恢复会话、查看进度与成本。所有支柱的状态在这里变成可点击、可检索的界面。快速上手两步接入你的项目git clone https://gitcode.com/GitHub_Trending/cl/pilot-shell cd pilot-shell bash install.sh安装器是幂等的 8 步流程失败自动回滚会自动为 Claude Code 与 Codex 分别适配资产。装完后直接运行claude或codex即可框架自动生效。小结为什么说这是框架而不是配置合集规则供给共识MCP供给上下文技能供给流程钩子供给强制力——四者缺一个闭环就断了停止守卫与独立评审把看起来完成变成有证据的完成上下文在压缩与长任务中可恢复、跨 Claude Code 与 Codex 持久共享更多细节可参考仓库内的官方文档Hooks 管线、规则与标准、MCP 服务器与知识系统。【免费下载链接】pilot-shellProfessional context and harness engineering for Claude Code and OpenAI Codex. Build production-grade software with spec-driven development, TDD, persistent memory, quality gates, code intelligence, human oversight, and end-to-end verification.项目地址: https://gitcode.com/GitHub_Trending/cl/pilot-shell创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考