# Skills Overview

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

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

安装与使用详见 [SKILLS.md](../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-syntax-reference`   | 查询 TSL 语法条目，验证具体写法和错误边界；不负责 API、命名、风格、工具链或模块集成 | 写/改/审 TSL 时确认语言结构、表达式、控制流、对象模型和语法限制       |
| `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、设计模式误用和代码工匠实践审查     |
