---

name: squirrel description: "全周期 AI 编码技能：规划、构建、测试、代码检查、修复 bug 并编写生产级文档。自动检测项目状态并调整其 8 阶段流水线。" category: development risk: safe source: community source_repo: flyingsquirrel0419/squirrel-skill source_type: community license: "Apache-2.0" license_source: "https://github.com/flyingsquirrel0419/squirrel-skill/blob/main/LICENSE" date_added: "2026-04-29" author: flying_squirrel__ tags: [development, testing, planning, code-review, documentation, ci-cd] tools: [claude, cursor, codex, antigravity, gemini, windsurf, opencode, copilot]

Squirrel — 全周期软件开发技能

概述

Squirrel 是一个全周期 AI 编码技能，可在 9 个 AI 编码代理上运行。它自动检测项目状态（全新项目、进行中或成熟项目）并相应调整其 8 阶段工程流水线。它不是一刀切的工作流，而是判断项目实际所处阶段，然后在恰当的位置切入。

何时使用本技能

• 从零开始新项目时使用（全新项目）
• 改进现有代码库时使用（进行中或成熟项目）
• 修复 bug、添加功能或重构时使用
• 为项目添加测试、代码检查或 CI/CD 时使用
• 编写生产级文档时使用
• 当用户说"帮我构建"、"修复这个"、"squirrel 这个项目"或任何多步骤开发任务时使用

工作原理

步骤 0：检测模式

Squirrel 对项目目录进行分类：

| 信号 | 模式 | 入口点 | |--------|------|-------------| | 空目录 | 全新项目 | 从头执行全部 8 个阶段 | | 有源文件，无测试/文档 | 进行中 | 先审计，再改进 | | 源码 + 测试 + CI + README | 成熟项目 | 针对性改进 | | "修复这个 bug / 添加功能" | 定向 | 仅限范围内工作 |

8 阶段流水线

1. 发现 — 理解项目（审计现有代码或收集需求）
2. 规划 — 具体任务列表，包含依赖关系和完成标准
3. 构建 — 编写或修改代码（支持时使用并行子代理）
4. 测试 — 运行现有测试，编写新测试，目标 70%+ 覆盖率
5. Bug 猎手 — 静态分析 + 人工审查
6. 打磨 — 代码检查、格式化、类型检查、移除死代码
7. 文档 — README + 内联文档（更新现有内容，不覆盖）
8. 发布 — 最终检查清单：测试通过、无密钥泄露、CI 已配置

失败恢复（三振出局规则）

1. 第一振： 修复具体错误。运行测试。继续前进。
2. 第二振： 重新阅读代码。尝试不同方法。
3. 第三振： 停止。回滚。记录失败原因。询问用户。

示例

示例 1：构建 REST API

> build me a REST API for a todo app with TypeScript and Express

Squirrel 自动检测为全新项目模式并执行全部 8 个阶段。

示例 2：修复 bug

> fix this bug in src/auth/login.py

Squirrel 进入定向模式——简化审计、范围内修复、验证。

示例 3：改进现有项目

> squirrel this project — add tests, fix lint errors, write README

Squirrel 审计现有代码库，然后应用第 4-8 阶段。

最佳实践

• 尊重现有代码——匹配命名约定、测试框架、导入风格和架构
• 编写新文件前先阅读 2-3 个类似文件
• 绝不用 as any 或 @ts-ignore 压制类型错误
• 绝不删除失败的测试来"通过"
• 绝不让代码处于损坏状态

平台兼容性

Squirrel 可在以下平台运行：Claude Code、Codex、Cursor、Antigravity、Gemini CLI、GitHub Copilot、Windsurf、OpenCode、Aider（共 9 个）。

安装方式：

# 通用安装器
npx skills add flyingsquirrel0419/squirrel-skill

限制

• 不能替代环境特定的验证或专家审查
• CI/CD 模板是起点，不是即插即用的保证
• 并行子代理执行取决于平台支持

相关技能

• @brainstorming - 用于实施前的规划
• @test-driven-development - 用于 TDD 导向的工作流
• @systematic-debugging - 用于系统化的问题解决