
关于
全周期 AI 编码技能:规划、构建、测试、代码检查、修复缺陷和编写生产级文档。自动检测项目状态并适配其 8 阶段流水线。
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 阶段流水线
- 发现 — 理解项目(审计现有代码或收集需求)
- 规划 — 具体任务列表,包含依赖关系和完成标准
- 构建 — 编写或修改代码(支持时使用并行子代理)
- 测试 — 运行现有测试,编写新测试,目标 70%+ 覆盖率
- Bug 猎手 — 静态分析 + 人工审查
- 打磨 — 代码检查、格式化、类型检查、移除死代码
- 文档 — README + 内联文档(更新现有内容,不覆盖)
- 发布 — 最终检查清单:测试通过、无密钥泄露、CI 已配置
失败恢复(三振出局规则)
- 第一振: 修复具体错误。运行测试。继续前进。
- 第二振: 重新阅读代码。尝试不同方法。
- 第三振: 停止。回滚。记录失败原因。询问用户。
示例
示例 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- 用于系统化的问题解决
兼容工具
Claude CodeCursor
标签
通用