Skip to content

docs(openclaw): 移除 stale slash command 引用,改自然语言触发#25

Merged
jnMetaCode merged 1 commit intomainfrom
docs/fix-openclaw-slash-command-stale-refs
May 11, 2026
Merged

docs(openclaw): 移除 stale slash command 引用,改自然语言触发#25
jnMetaCode merged 1 commit intomainfrom
docs/fix-openclaw-slash-command-stale-refs

Conversation

@jnMetaCode
Copy link
Copy Markdown
Owner

Summary

audit v1.3.0 release 时发现 docs/README.openclaw.md "使用"段还在写:

- 输入 `/brainstorming` 开始头脑风暴
- 输入 `/commit` 使用中文提交规范

两条都是过时/错误引用:

  • /brainstorming 不是有效 slash command。commands/ 目录在上游 v5.1.0 已删(我们 v1.3.0 跟随删除),而且我们 commands/从来没有 brainstorming 这个名字(被删的是 /brainstorm / /execute-plan / /write-plan)。
  • /commit 完全不存在 —— 我们没有 commit 这个 skill。最接近的是 chinese-commit-conventions,但 slash command 形式也不存在。
  • 即便 commands/ 还在的年代,OpenClaw 也不一定把 skill 自动暴露为 slash command(我没有 OpenClaw 环境验证,但官方文档没明确说支持)。

改动

docs/README.openclaw.md 第 63-70 行:

  • 改写为 OpenClaw 实际生效的触发方式:AI 通过 skill frontmatter 的 description 字段自主选择 skill
  • 给出 4 个高频场景示例(brainstorming / chinese-commit-conventions / systematic-debugging / requesting-code-review)
  • 说明强制触发的方式(在指令里点名 skill)

Test plan

  • markdown 语法 OK
  • 4 个 skill 名(brainstorming / chinese-commit-conventions / systematic-debugging / requesting-code-review)在仓库 skills/ 目录下都存在
  • CI 跑过

关联

audit 见 #19 评论(v1.3.0 release 后的全链路检查)。

OpenClaw 安装指南的"使用"段写"输入 /brainstorming 开始头脑风暴"和
"输入 /commit 使用中文提交规范"——这两条都是过时引用:

- `/brainstorming` 不是有效 slash command(commands/ 目录在 v5.1.0 已删,
  且我们的 commands/ 里也从来没有 brainstorming 这个名字)
- `/commit` 完全不存在(我们没有 commit 这个 skill;可能想表达
  chinese-commit-conventions,但 slash command 形式也不存在)
- 即便 commands/ 还在的年代,OpenClaw 也不一定把 skill 自动暴露为
  slash command

改写为 OpenClaw 实际生效的触发方式:AI 通过 skill frontmatter 的
description 字段自主选择 skill。文档同时给出 4 个高频触发场景示例,
并说明强制触发的方式(在指令里点名 skill)。
@jnMetaCode jnMetaCode merged commit 7bc9acd into main May 11, 2026
1 check passed
@jnMetaCode jnMetaCode deleted the docs/fix-openclaw-slash-command-stale-refs branch May 11, 2026 13:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant