# Skills Overview

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

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

安装与使用详见 [SKILLS.md](../SKILLS.md)。

## 一方 Skills

| Skill                  | 作用                                                                                               | 典型场景                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `commit-message`       | 根据 staged diff 生成符合仓库规范的提交信息，并判断是否应拆分提交                                  | 写 commit message、检查 staged 改动是否适合一个提交                   |
| `gitea-fix-ci`         | 基于 Gitea Actions run/job/log 诊断失败 CI，先形成修复计划再改代码；含 `fetch_ci_logs.py` 取证脚本 | Gitea PR checks 失败、远端 CI 红但本地需要定位                        |
| `cook-it-through`      | 运行任务路由、Matt 工程主链和本地 Markdown ticket 生命周期                                         | 处理实质性工程任务，或操作 `.scratch` queue、claim、finish、integrate |
| `tsl-syntax-reference` | 查询 TSL 语法条目，验证具体写法和错误边界；不负责 API、命名、风格、工具链或模块集成                | 写/改/审 TSL 时确认语言结构、表达式、控制流、对象模型和语法限制       |
| `tsl-api-reference`    | 查询 TSL API、class/framework 契约和天软数据字典；按 workflow 路由并由脚本 help 定义调用契约       | 确认 API/成员/回调的签名和示例，或按中文业务含义查表、数据源与字段    |

## 第三方 Skills

### Matt Pocock Engineering Workflow

正式工程主链来自 `mattpocock/skills`，使用本地 Markdown tracker 和 ticket DAG。

| Skill                          | 作用                                           |
| ------------------------------ | ---------------------------------------------- |
| `setup-matt-pocock-skills`     | 配置 tracker、领域文档和 agent 入口            |
| `grill-with-docs` / `grilling` | 收敛 design tree 并同步领域词汇/ADR            |
| `to-spec`                      | 把已确认上下文合成为 feature spec              |
| `to-tickets`                   | 拆成带 blocking edges 的 tracer-bullet tickets |
| `tdd`                          | 在约定 seam 上按 ticket 采用测试驱动实现和验证 |
| `code-review`                  | 对固定点后的提交做 Standards/Spec 双轴审查     |
| `handoff`                      | 跨 session 交接未完成上下文                    |

安装时使用 `mode = "all"`，或在 `skills` 中逐项列出主链、`cook-it-through` 及其依赖；
安装器不推导 skill 依赖。`cook-it-through` 同时定义工程和本地 ticket 协议，并由其内部
执行引擎强制执行状态机。

### 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、热点分析、重构前侦察 |

### 其他

| Skill           | 作用                                                     |
| --------------- | -------------------------------------------------------- |
| `ui-ux-pro-max` | UI/UX 设计知识库，包含风格、配色、字体、组件和栈相关建议 |
| `cangjie-skill` | 将书籍、课程、访谈等长内容蒸馏为原子化、可执行的 skills  |
| `darwin-skill`  | 评估并迭代优化 skills，以测试提示和成对评审控制质量回归  |