catalog/repos/ak1ra-komj--agents-skills.md

37 lines
1.8 KiB
Markdown
Raw Normal View History

2026-04-07 11:44:56 +08:00
# 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` | 在用户要求总结本次会话、写会话日志、保存今天所做的工作或类似需求时使用。 |