npx skills add https://github.com/charon-fan/agent-playbook --skill create-pr一个用于创建拉取请求并自动更新双语文档的技能。该技能确保在提交代码变更时,英文和中文文档保持同步。
当您执行以下操作时,此技能将激活:
检查当前分支中的所有变更:
git status
git diff
git log --oneline main..HEAD
识别:
首先,检测是否有任何技能被更改:
# 检查 skills/ 目录是否有变更
git diff --name-only main..HEAD | grep "^skills/"
| 变更类型 | 文档操作 |
|---|
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 添加新技能 | 在英文和中文 README 的技能表中添加 |
| 技能描述更改 | 更新技能表中的描述 |
| 技能移除 | 从技能表中移除 |
| 技能钩子更改 | 更新技能表中的自动触发列 |
| 仅内部技能逻辑 | 跳过 README 更新 |
| 不影响用户的错误修复 | 跳过 README 更新 |
如果技能的 metadata.hooks 前置元数据被修改,技能目录中的自动触发列必须更新:
# 检查钩子是否被修改
git diff main..HEAD -- skills/*/SKILL.md | grep -E "^\+.*metadata:|^\+.*hooks:|^\+.*trigger:"
如果钩子已更改 → 更新 README.md 和 README.zh-CN.md 中的自动触发列。
使用 commit-helper 格式:
<type>(<scope>): <subject>
<body>
<footer>
类型:
feat:新技能或功能fix:错误修复或更正docs:仅文档更改refactor:代码重构chore:维护任务运行以下序列:
# 1. 暂存并提交更改
git add .
git commit -m "commit message"
# 2. 推送到远程
git push -u origin <branch-name>
# 3: 使用 gh CLI 创建 PR
gh pr create \
--title "PR title" \
--body "PR description"
创建 PR 后,更新两个 README 文件:
README.md(英文):
README.zh-CN.md(中文):
对于重大更改,添加到 CHANGELOG.md:
## [版本] - YYYY-MM-DD
### 新增
- 新技能:skill-name
### 修复
- 修复了 skill-name 中的问题
### 更改
- 使用新功能更新了 skill-name
添加或修改技能时,请使用此格式更新技能目录:
英文(README.md):
### 类别名称
| Skill | Description | Auto-Trigger |
|-------|-------------|--------------|
| **[skill-name](./skills/skill-name/)** | 简短描述 | Manual / Auto / Background / (keyword: "...") |
中文(README.zh-CN.md):
### 类别名称
| 技能 | 描述 | 自动触发 |
|------|------|----------|
| **[skill-name](./skills/skill-name/)** | 简短描述 | 手动 / 自动 / 后台 / (关键词:"...") |
| 值 | 含义 | 示例 |
|---|---|---|
Manual | 用户必须调用 | 大多数开发技能 |
Auto | 在任何技能后自动触发 | session-logger |
Background | 在相关技能后非阻塞运行 | self-improving-agent |
After skill updates | 仅在技能被修改时触发 | create-pr |
(keyword: "...") | 在特定关键词上激活 | prd-planner (keyword: "PRD") |
始终在以下情况更新:
考虑在以下情况更新:
在以下情况跳过更新:
向技能表添加新技能时:
英文(README.md):
| **[skill-name](./skills/skill-name/)** | 简短技能描述 |
中文(README.zh-CN.md):
| **[skill-name](./skills/skill-name/)** | 技能简短描述 |
两个 README 文件顶部都必须有语言切换链接:
README.md:
English | [简体中文](./README.zh-CN.md)
README.zh-CN.md:
[English](./README.md) | 简体中文
创建 PR 时,请使用此模板:
## 摘要
<此 PR 功能的简要描述>
## 变更
- [ ] 添加了新技能
- [ ] 修改了现有技能
- [ ] 更新了文档
- [ ] 添加/更新了测试
## 受影响的技能
- `skill-name`:变更描述
## 文档
- [x] README.md 已更新
- [x] README.zh-CN.md 已更新
- [ ] CHANGELOG.md 已更新(如果适用)
## 测试计划
- [ ] 在 Claude Code 中测试了技能
- [ ] 验证了文档链接
- [ ] 检查了双语翻译
---
🤖 由 [Claude Code](https://claude.com/claude-code) 生成
# 1. 创建技能文件
mkdir -p skills/new-skill
touch skills/new-skill/SKILL.md
touch skills/new-skill/README.md
# 2. 创建符号链接
ln -s ~/path/to/agent-playbook/skills/new-skill/SKILL.md ~/.claude/skills/new-skill.md
# 3. 更新 README.md(添加到技能表)
# 4. 更新 README.zh-CN.md(添加到技能表并翻译)
# 5. 提交并推送
git add skills/new-skill/ README.md README.zh-CN.md
git commit -m "feat: add new-skill for ..."
git push -u origin feature/add-new-skill
# 6. 创建 PR
gh pr create --title "feat: add new-skill" --body "..."
# 1. 对技能进行更改
vim skills/existing-skill/SKILL.md
# 2. 检查描述是否更改
git diff skills/existing-skill/SKILL.md
# 3. 如果描述已更改,更新 README 文件
# 4. 提交、推送、创建 PR
# 1. 修复错误
vim skills/some-skill/SKILL.md
# 2. 提交并推送(无需更新 README)
git add skills/some-skill/SKILL.md
git commit -m "fix: correct typo in some-skill"
git push
# 3. 创建 PR
gh pr create --title "fix: correct typo in some-skill"
创建 PR 前,请验证:
| 命令 | 用途 |
|---|---|
git status | 检查当前状态 |
git diff | 查看未暂存的更改 |
git log main..HEAD | 查看分支提交 |
git add . | 暂存所有更改 |
git commit -m "msg" | 提交并附带消息 |
git push -u origin branch | 推送到远程 |
gh pr create | 创建拉取请求 |
每周安装次数
55
仓库
GitHub 星标数
11
首次出现时间
Jan 22, 2026
安全审计
安装于
gemini-cli48
opencode47
codex47
cursor45
github-copilot42
amp42
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
125,100 周安装