73 lines
3.7 KiB
Markdown
73 lines
3.7 KiB
Markdown
# Skills Overview
|
||
|
||
本目录放置 Playbook 可安装的 AI agent skills。
|
||
|
||
- 一方 skill 位于 `skills/<name>/SKILL.md`，由本仓库维护。
|
||
- 第三方 skill 位于 `skills/thirdparty/<name>/SKILL.md`，由同步流程生成或更新。
|
||
- 第三方来源登记见 `skills/thirdparty/thirdparty-skills.yml` 与
|
||
`.gitea/ci/thirdparty_skills.json`。
|
||
|
||
## 一方 Skills
|
||
|
||
| Skill | 作用 | 典型场景 |
|
||
| --- | --- | --- |
|
||
| `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、代码改完后的风格整理 |
|
||
|
||
## 已同步第三方 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 的写作规范 |
|
||
|
||
### Other Synced Third-party Skills
|
||
|
||
| Skill | 来源 | 作用 |
|
||
| --- | --- | --- |
|
||
| `ui-ux-pro-max` | `ui-ux-pro-max-skill` | UI/UX 设计知识库，包含风格、配色、字体、组件和栈相关建议 |
|
||
| `karpathy-guidelines` | `andrej-karpathy-skills` | 写代码、审查、重构时降低 LLM 常见错误：保持简单、聚焦、可验证 |
|
||
|
||
## 已登记待同步 Third-party Skills
|
||
|
||
这些来源已登记，后续同步后会落到 `skills/thirdparty/`。
|
||
|
||
### brooks-lint Suite
|
||
|
||
`brooks-lint` 是一个套件来源，不是单个 skill。同步时会包含多个下游 skill
|
||
以及共享资料目录：
|
||
|
||
| 下游项 | 隶属 | 作用 |
|
||
| --- | --- | --- |
|
||
| `brooks-review` | `brooks-lint` | 常规 PR / diff code review |
|
||
| `brooks-audit` | `brooks-lint` | architecture audit、系统性结构问题审查 |
|
||
| `brooks-debt` | `brooks-lint` | technical debt review |
|
||
| `brooks-health` | `brooks-lint` | 项目健康度检查 |
|
||
| `brooks-sweep` | `brooks-lint` | 扫描式问题发现 |
|
||
| `brooks-test` | `brooks-lint` | 测试质量审查 |
|
||
| `_shared` | `brooks-lint` | brooks 系列 skill 共享参考资料，不是独立使用的 skill |
|
||
|
||
### Single-skill Sources
|
||
|
||
| Skill | 来源 | 作用 |
|
||
| --- | --- | --- |
|
||
| `codebase-recon` | `outfitter-dev/agents` | 通过 git 历史和代码结构做 risk scan、热点分析、重构前侦察 |
|
||
| `codebase-migrate` | `awesome-codex-skills` | 大代码库迁移、多文件 refactor、分批变更与 CI 验证工作流 |
|