playbook/skills

Skills Overview

本目录包含 Playbook 提供的 AI agent skills，分为两类：

• 一方 skills：本仓库维护（skills/<name>/）
• 第三方 skills：同步自外部来源（skills/thirdparty/<name>/）

安装与使用详见 SKILLS.md。

一方 Skills

Skill	作用	典型场景
bulk-refactor-workflow	大规模重构工作流：符号重命名、API 迁移、安全机械变更	跨多文件重命名、API 替换、批量代码转换
commit-message	根据 staged diff 生成符合仓库规范的提交信息，并判断是否应拆分提交	写 commit message、检查 staged 改动是否适合一个提交
gitea-fix-ci	基于 Gitea Actions run/job/log 诊断失败 CI，先形成修复计划再改代码	Gitea PR checks 失败、远端 CI 红但本地需要定位
style-cleanup	使用仓库既有 formatter/linter 做格式和 lint 收尾，不改变语义	格式化、lint cleanup、代码改完后的风格整理
tsl-api-reference	查询随 skill 分发的 TSL API 参考：按名精确查条目，或按中文关键词发现候选	写/审 TSL 时确认 builtin、dotnet、模块 API 的签名、参数、返回值和示例

第三方 Skills

Superpowers Workflow Suite

这些 skill 来自 superpowers，主要提供计划、执行、调试、验证和审查工作流。

Skill	作用
using-superpowers	会话开始时判断并加载适用 skill
brainstorming	需求澄清、方案讨论、设计文档产出
writing-plans	把设计或需求拆成可执行 implementation plan
executing-plans	按已写好的 plan 执行任务
subagent-driven-development	用子 agent 按任务执行、审查和迭代 plan
dispatching-parallel-agents	多个互不依赖问题并行分派
using-git-worktrees	需要隔离工作区时创建或使用 git worktree
finishing-a-development-branch	开发分支完成后的合并、PR、保留或丢弃流程
test-driven-development	新功能、bugfix、重构前的 TDD 流程
systematic-debugging	bug、测试失败、异常行为的根因定位流程
verification-before-completion	声称完成、修复或通过前的验证门禁
requesting-code-review	主动请求代码审查，通常用于任务完成或合并前
receiving-code-review	处理别人给出的 review 意见，判断采纳、反驳或澄清
writing-skills	创建、修改或验证 skill 的写作规范

brooks-lint Suite

Code review 和质量审查工具集，包含共享参考资料目录 _shared。

Skill	作用
brooks-review	常规 PR / diff code review
brooks-audit	architecture audit、系统性结构问题审查
brooks-debt	technical debt review
brooks-health	项目健康度检查
brooks-sweep	扫描式问题发现
brooks-test	测试质量审查

代码库侦察与迁移

Skill	作用
codebase-recon	通过 git 历史和代码结构做 risk scan、热点分析、重构前侦察
pathfinding	需求澄清和 confidence calibration
codebase-migrate	大代码库迁移、多文件 refactor、分批变更与 CI 验证工作流

其他

Skill	作用
ui-ux-pro-max	UI/UX 设计知识库，包含风格、配色、字体、组件和栈相关建议
karpathy-guidelines	写代码、审查、重构时降低 LLM 常见错误：保持简单、聚焦、可验证
uncle-bob-craft	Clean Architecture、SOLID、设计模式误用和代码工匠实践审查