82 lines
3.8 KiB
Markdown
82 lines
3.8 KiB
Markdown
# AI编码智能技能库
|
||
|
||
`GitHub Copilot` `AI智能体` `技能包` `npm` `自动化`
|
||
|
||
# Skills
|
||
|
||
[](https://github.com/abuxton/Skills/actions)
|
||
[](https://www.npmjs.com/package/@abuxton/skills)
|
||
[](https://github.com/abuxton/Skills/blob/main/LICENSE)
|
||
|
||
面向 GitHub Copilot 及其他编码智能体的技能包，遵循 [agentskills.io 规范](https://agentskills.io/specification) 构建，可通过 [skills-npm](https://github.com/antfu/skills-npm) 发布。
|
||
|
||
## 最爱的 XKCD
|
||
|
||
[](https://xkcd.com/927/)
|
||
|
||
我最喜欢的是 XKCD 第 927 期《标准》——对于一个充满可复用工具和规范的仓库来说，这个选择实在是太应景了。
|
||
|
||
## 可用技能
|
||
|
||
| 名称 | 描述 |
|
||
| ---- | ---- |
|
||
| [act](skills/act/SKILL.md) | 使用 nektos/act 在本地运行、调试和排查 GitHub Actions 问题。 |
|
||
| [shields-badges](skills/shields-badges/SKILL.md) | 分析仓库的主要方向和技术栈，并为 Markdown 文件添加合适的 [shields.io](https://shields.io) 徽标。 |
|
||
| [writing-skills](skills/writing-skills/SKILL.md) | 按照 agentskills.io 规范编写高质量的智能体技能，包含正确的 frontmatter、工作流结构和参考资源。 |
|
||
| [publishing-npm](skills/publishing-npm/SKILL.md) | 准备并发布一个包含智能体技能的 npm 包，遵循 skills-npm 的技能打包与分发规范。 |
|
||
| [github-gist](skills/github-gist/SKILL.md) | 使用 gh CLI 创建、管理和整理 GitHub Gist。 |
|
||
| [gitattributes-manager](skills/gitattributes-manager/SKILL.md) | 创建、审查并安全更新 `.gitattributes` 文件，采用保守的 Unix 优先默认值并明确说明每条属性的用途。 |
|
||
| [xkcd-says-what](skills/xkcd-says-what/SKILL.md) | 获取匹配的 XKCD 漫画，并生成经过验证的 Markdown 或 HTML 嵌入代码，供文档或终端使用。 |
|
||
| [asciinema-record](skills/asciinema-record/SKILL.md) | 使用 asciinema 将终端会话录制为命名 .cast 文件，裁剪至标记内容，并可选择使用 agg 转换为 GIF。 |
|
||
| [do-nothing-scripting](skills/do-nothing-scripting/SKILL.md) | 从 asciinema `.cast` 文件、纯文本文件、Shell 历史输出或用户访谈中提炼"什么都不做"的 bash 脚本——将每个步骤编码为手动提示，操作者可在之后替换为真正的自动化命令。 |
|
||
|
||
## 使用方式
|
||
|
||
|
||
|
||
### 通过 npx（推荐）
|
||
|
||
使用 [npx](https://github.com/antfu/skills-npm) 安装包并为内置技能创建符号链接：
|
||
|
||
```bash
|
||
npx skills -h
|
||
> Usage: skills <command> [options]
|
||
...
|
||
|
||
npx skills install @abuxton/skills
|
||
```
|
||
|
||
### 通过 npm
|
||
|
||
使用 [skills-npm](https://github.com/antfu/skills-npm) 安装包并为内置技能创建符号链接：
|
||
|
||
```bash
|
||
npm install @abuxton/skills
|
||
npx skills-npm
|
||
```
|
||
|
||
若要在每次 `npm install` 时自动创建符号链接，可在 `package.json` 中添加 `prepare` 脚本：
|
||
|
||
```json
|
||
{
|
||
"scripts": {
|
||
"prepare": "npx skills-npm"
|
||
}
|
||
}
|
||
```
|
||
|
||
`skills-npm` 会在项目中以 `skills/npm-<包名>-<技能名>` 的形式创建符号链接。将以下规则加入 `.gitignore` 以避免将其提交：
|
||
|
||
```gitignore
|
||
skills/npm-*
|
||
```
|
||
|
||
### 手动安装
|
||
|
||
将技能文件夹复制到本地的 `skills/` 目录，并在 Copilot 提示词中引用，或让智能体自动发现它。
|
||
|
||
每个技能文件夹包含一个 `SKILL.md` 指令文件以及可选的参考资源。
|
||
|
||
## 贡献
|
||
|
||
请参阅 [AGENTS.md](AGENTS.md) 了解如何编写新技能并通过 npm 发布的相关指引。 |