Prefer slash commands for Codex skills

This commit is contained in:
zfc
2026-03-11 16:17:54 +08:00
parent 1c89cf94c6
commit b36220b33a
5 changed files with 42 additions and 43 deletions
+3 -2
View File
@@ -28,13 +28,14 @@
- `doc`: 渐进式文档生成器。首次只写精炼梗概(≤300字),后续通过迭代不断完善。 (file: `./.codex/skills/doc/SKILL.md`)
- `update`: 收集用户反馈并更新最近使用的 skill。别名:`up`。 (file: `./.codex/skills/up/SKILL.md`)
- `deploy`: Drone CI + 服务器 CD 全流程引导:从基础设施检查到生成配置文件到验证部署,交互式完成。 (file: `./.codex/skills/deploy/SKILL.md`)
- `issue`: 获取任意 Gitea 仓库的 issue 列表和单条详情,支持状态筛选、完整仓库 URL 输入和格式化输出。 (file: `./.codex/skills/issue/SKILL.md`)
- `changelog`: 一键发版:生成更新日志 → commit → 打 tag,全流程自动化。 (file: `./.codex/skills/changelog/SKILL.md`)
### How to use skills
- Discovery: 以上列表就是当前项目注册给 Codex 的 skills。
- Trigger rules: 如果用户显式提到 skill 名称(例如 `$rr`、`rr skill`、`用 rr 评审`),或任务明显匹配 skill 描述,优先使用对应 skill。
- Codex usage: 在 Codex 中优先使用 `$skill-name` 或自然语言;skill 文档里出现的 `/rr`、`/go` 等 slash command 只是 Claude Code 的兼容写法
- Trigger rules: 如果用户显式提到 skill 名称(例如 `/rr`、`$rr`、`rr skill`、`用 rr 评审`),或任务明显匹配 skill 描述,优先使用对应 skill。
- Codex usage: 在 Codex 中优先使用 `/skill-name`;兼容历史 `$skill-name` 写法,也支持自然语言触发
- Missing/blocked: 如果某个 skill 文件不存在或无法读取,简短说明并回退到普通实现方式。
- Context hygiene: 只按需打开 `SKILL.md`,不要一次性加载整个 skill 仓库。
+3 -3
View File
@@ -7,7 +7,7 @@ description: 渐进式文档生成器。首次只写精炼梗概(≤300字)
> **核心理念**:文档是缝缝补补长出来的,不是一步到位写出来的。首次只写最重要的梗概,后续通过讨论和迭代逐步完善。
当用户调用 `doc` skill、`$doc`,或自然语言要求“用 doc 写文档”时,执行以下步骤:
当用户调用 `doc` skill、`/doc``$doc`,或自然语言要求“用 doc 写文档”时,执行以下步骤:
## 1. 理解需求
@@ -78,14 +78,14 @@ author: {作者署名}
文档: {标题} | 版本: v1.0 | 路径: {path}
字数: ~{N}字(首版梗概)
后续可以通过 $doc 继续补充完善。
后续可以通过 /doc 继续补充完善。
主人,用不用我沉淀 or git 提交?
```
## 工作流总览
```text
$doc <指令>
/doc <指令>
├── 1. 理解需求(简短确认主题、路径、署名)
├── 2. 快速调研(聚焦核心,不求全面)