Prefer slash commands for Codex skills
This commit is contained in:
@@ -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 仓库。
|
||||
|
||||
|
||||
@@ -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. 快速调研(聚焦核心,不求全面)
|
||||
|
||||
Reference in New Issue
Block a user