Agent Skills
返回列表
🤖

Pilot Shell 规范驱动的 Claude Code 质量门禁

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_3c6cb52e/run-claude-code-with-spec-driven-quality-gates-via-pilot-shell。

技能介绍

解决的问题

直接让 Claude Code 改代码的问题在于：需求没有固定成规范，实现落地前也没有验证关卡。模型生成的改动可能看起来正确，但未经端到端验证就合入主干，风险全部留给事后 review。这个技能把高风险实现工作包裹在三层流程里：先写规范，再走审批，最后做验证。

核心能力

规范驱动开发（/spec）：通过 pilot 命令启动，把需求固化为可执行的 spec，模型的实现必须对照规范进行。

RED 测试先行：先通过现有公开入口（public entry point）写出必然失败的测试，运行后确认失败症状与文档记录一致，再开始实现。

语言服务器实时诊断：内置 Python（basedpyright）、TypeScript（vtsls）、Go（gopls）的 LSP 支持，自动安装与配置，写码过程中即时报错。

端到端验证：这是主要的正确性信号。用原始输入运行真实程序：UI 链路走 Claude Code Chrome → Chrome DevTools MCP → playwright-cli → agent-browser；CLI、API、REPL、job trigger 各有对应验证路径。

pilot bot 自动化：需要 7x24 小时运行的任务交给 pilot bot。

适用边界

  • 仅支持 macOS、Linux 和 WSL2，Windows 原生环境不可用。
  • 依赖 Claude Code、curl、bash 三个前置工具。
  • UI 验证链路依赖浏览器自动化组件，纯后端无界面的项目用不到那条链路。
  • 内容提炼自上游 Pilot Shell 文档，安装与配置细节以官方文档为准。

使用场景

  • 团队准备用 Claude Code 改核心模块，需先把需求写成规范并走审批，再让模型实现，避免直接改生产代码。
  • 维护 Python/TypeScript/Go 混合仓库，希望模型写码时获得 LSP 实时诊断，边写边发现类型错误和静态问题。
  • 需要 7x24 小时运行 Claude Code 处理批量任务如定期重构或生成测试，用 pilot bot 持续执行无需人工盯守。
  • 想确保 Claude Code 的改动通过真实输入跑通整条链路（UI 走 playwright，API/CLI 走对应调用），验证通过才算完成。

适合人员

  • 多人协作仓库的工程团队负责人，希望 AI 改动合入主干前先过规范审批与验证，而非全靠事后 review 兜底。
  • 维护 Python/TypeScript/Go 既有代码库的后端或全栈工程师，想用 Claude Code 加速改动，需要 LSP 实时诊断发现类型错误。
  • 管理自动化流水线的 DevOps 工程师，想让 AI 代理 7x24 持续处理批量任务如定期生成测试和重构。
  • 对 AI 生成代码质量存疑的技术负责人，需要在高风险模块改动时强制走 spec 审批与端到端验证流程。