playbook/skills/README.md

Skills Overview

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

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

安装与使用详见 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
implement / 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、热点分析、重构前侦察
pathfinding	需求澄清和 confidence calibration
codebase-migrate	大代码库迁移、多文件 refactor、分批变更与 CI 验证工作流

其他

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