37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# AI编程助手技能集
|
||
|
||
`AI助手` `技能库` `GitHub Copilot` `Cursor` `自动化`
|
||
|
||
# agents-skills
|
||
|
||
一个为 AI 编程助手（GitHub Copilot、Cursor 等）精心整理的技能集合。
|
||
|
||
## 安装
|
||
|
||
将所有技能安装到当前项目：
|
||
|
||
```bash
|
||
npx skills add ak1ra-komj/agents-skills
|
||
```
|
||
|
||
将所有技能全局安装（在所有项目中均可使用）：
|
||
|
||
```bash
|
||
npx skills add -g ak1ra-komj/agents-skills
|
||
```
|
||
|
||
## 编写技能
|
||
|
||
在编写新技能或参考文档时，请确保 `description` 字段使用 **"Use when [条件]"** 的形式——一个精确的、面向触发条件的短语，告诉 Agent 何时加载该文件。模糊的描述会导致技能被跳过或误用。
|
||
|
||
## 可用技能
|
||
|
||
| 技能 | 描述 |
|
||
| ---- | ---- |
|
||
| `avoid-ai-writing-patterns` | 在撰写非技术性文章（如博客、Wiki 内容、项目描述等）且需要自然直接的表达风格时使用。不适用于技术文档、API 文档或提交信息。 |
|
||
| `developing-ansible` | 在编写、审查或重构 Ansible playbook、role 或 task 时使用。 |
|
||
| `developing-bash-scripts` | 在编写、审查或重构 Bash 脚本时使用。 |
|
||
| `developing-posix-shell-scripts` | 在编写、审查或重构 POSIX shell 脚本（`/bin/sh`），或目标环境为 Alpine、BusyBox 或无法保证存在 Bash 的环境时使用。 |
|
||
| `init-agents-md` | 在用户要求创建或覆盖 `AGENTS.md`、编写 Agent 指南、为 AI Agent 记录项目文档，或为新仓库配置 AI 编程工具时使用。 |
|
||
| `keep-a-changelog` | 在用户提到准备或发布新版本，或要求审查、重构 `CHANGELOG.md` 时使用，遵循 Keep a Changelog 格式和语义化版本规范。 |
|
||
| `summarize-current-session` | 在用户要求总结本次会话、写会话日志、保存今天所做的工作或类似需求时使用。 | |