65 lines
4.2 KiB
Markdown
65 lines
4.2 KiB
Markdown
# 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 红但本地需要定位 |
|
||
| `tsl-syntax-reference` | 查询 TSL 语法条目，验证具体写法和错误边界；不负责 API、命名、风格、工具链或模块集成 | 写/改/审 TSL 时确认语言结构、表达式、控制流、对象模型和语法限制 |
|
||
| `tsl-api-reference` | 查询随 skill 分发的 TSL API 参考：按名精确查条目，或按中文关键词发现候选 | 写/审 TSL 时确认 builtin、dotnet、模块 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` 中逐项列出主链及其依赖；安装器不推导
|
||
skill 依赖。正式流程的调度、branch、worktree 和集成门禁由 `scripts/main_loop.py`
|
||
管理。
|
||
|
||
### 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，以测试提示和成对评审控制质量回归 |
|