关于 help
help 是 OrchestKit 的技能浏览工具,可按类别查看已安装技能或列出所有可由用户调用的技能。它会在运行时发现技能,避免依赖过时的固定列表。
主要功能
- 01运行时发现已安装技能
- 02按类别浏览技能
- 03列出所有用户可调用技能
- 04说明技能适用原因
适用场景
- 01浏览 BUILD 或 GIT 技能
- 02为任务查找相关技能
- 03查看所有可调用技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ yonatangross/ orchestkit --skill help安装后在 Claude Code 中输入/help确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
test-cases.jsonreferences/cc-keyboard-shortcuts.mdrules/_sections.mdskill-metadata-freshness.mdcategory-accuracy.md详细介绍
OrchestKit Skill Directory
动态发现技能:在运行时枚举已安装的插件,确保列表始终保持最新。
CC 2.1.121+ 提示: 如果你只想快速查找某项技能,现在原生
/skills命令支持输入过滤——打开命令并开始输入技能名称。如果你想按类别浏览或了解某项技能为何适用,请使用help。
快速开始
help # Show all categories
help build # Show BUILD skills only
help git # Show GIT skills only
help all # List every user-invocable skill
参数解析
CATEGORY = "$ARGUMENTS[0]" # Optional: build, git, plan, quality, memory, config, explore, design, ops, all
# If provided, skip AskUserQuestion and show that category directly.
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)
步骤 0:动态发现技能
始终先执行此步骤,以获取准确、最新的技能数据:
# ${CLAUDE_PLUGIN_ROOT} is set by the plugin runtime and points at the INSTALLED
# plugin. That is the normal case: a marketplace user has no src/ directory.
SKILLS_ROOT = "${CLAUDE_PLUGIN_ROOT}/skills"
matches = Grep(pattern="user-invocable:\\s*true", path=SKILLS_ROOT, output_mode="files_with_matches")
# Dogfooding fallback: inside the OrchestKit repo itself the skills live in the
# source tree. Retry there if the env var was unset or the probe found nothing.
if not matches:
SKILLS_ROOT = "src/skills"
matches = Grep(pattern="user-invocable:\\s*true", path=SKILLS_ROOT, output_mode="files_with_matches")
如果两次探测都未找到任何文件,请明确说明(“无法找到 OrchestKit
技能目录,已检查 ${CLAUDE_PLUGIN_ROOT}/skills 和 src/skills”)并停止。
不要用记忆中的技能名称列表替代。任何此类列表从一开始就会过时,而自信地给出错误答案比不给答案更糟。
对于每个匹配的文件,读取其 frontmatter,获取名称、描述、版本、
复杂度、argument-hint 和标签:
Read(file_path=f"{SKILLS_ROOT}/{skill_dir}/SKILL.md", limit=25)
之后显示的每个数字都必须根据此次扫描得出,不能作为字面值手动输入:
TOTAL = len(matches) # user-invocable skill count
动态构建技能列表。绝不硬编码数量或技能名称。
步骤 1:选择类别
如果提供了 CATEGORY 参数,请跳至步骤 2 并使用该类别。
否则,以交互方式呈现类别:
AskUserQuestion(
questions=[{
"question": "What type of task are you working on?",
"header": "Category",
# 4-option cap (CC schema): every category from STEP 2 is grouped into one of
# 3 buckets + "Show all". STEP 2 renders the constituent categories for the
# picked bucket. Descriptions name intents, never skills, so they cannot drift.
"options": [
{"label": "Build & ship", "description": "Writing code, tests, git and PRs, UI and design work"},
{"label": "Plan & assess", "description": "Requirements, planning, quality assessment, review"},
{"label": "Explore & operate", "description": "Codebase exploration, memory, setup, diagnostics, CI"},
{"label": "Show all", "description": "List every user-invocable skill"}
],
"multiSelect": false
}]
)
步骤 2:呈现类别
对于选定的类别,使用步骤 0 收集的数据呈现技能表。
类别定义
类别由标签谓词定义,而不是由技能名称列表定义,因此新发布的技能无需编辑此文件就能归入正确类别。将每个已发现技能的 frontmatter tags 与以下集合进行匹配(不区分大小写,匹配一项即可):
| 类别 | CLI 参数 | 匹配以下任意标签 |
|---|---|---|
| BUILD | build | implementation, feature, testing, coverage, test-generation, verification, e2e |
| GIT | git | git, github, commit, pull-request, pr, issue, bug-fix |
| PLAN | plan | planning, ideation, prd, requirements, visualization |
| QUALITY | quality | quality, assessment, evaluation, code-review, validation, grading |
| MEMORY | memory | memory, decisions, graph-memory, consolidation |
| CONFIG | config | setup, configuration, onboarding, diagnostics, health-check, dev-loop |
| EXPLORE | explore | exploration, codebase, code-search, architecture, discovery |
| DESIGN | design | design, design-context, design-tokens, design-to-code, frontend, ui, components, stylecards |
| OPS | ops | ci, automation, telemetry, observability, release, migration |
| OTHER | (无) | 上述各行均未匹配的任何标签 |
匹配两个类别的技能会同时列在这两个类别下。这是预期行为,并非错误。 OTHER 用于确保总数一致:步骤 0 找到的每项技能都必须出现在完整列表的某处,因此,尚未归入任何类别的技能也会显示出来。
步骤 1 的选择器仅提供3 个类别组(AskUserQuestion 架构限制每个问题最多有 4 个选项)。每个类别组会呈现对应类别的并集:
| 选择器类别组 | 呈现的类别 |
|---|---|
| 构建与发布 | BUILD + GIT + DESIGN |
| 规划与评估 | PLAN + QUALITY |
| 探索与运维 | MEMORY + CONFIG + EXPLORE + OPS + OTHER |
对于该类别中的每项技能,呈现:
/ork:{name} v{version} {complexity}
{description}
Example: /ork:{name} {argument-hint example}
“显示全部”——完整列表
如果用户选择“显示全部”,请根据步骤 0 的数据,按类别分组呈现所有用户可调用的技能,然后以计算得出的总数收尾:{TOTAL} user-invocable skills。
使用 len(matches) 输出 TOTAL。绝不输入未经刚刚统计的数字。
CC 内置命令(2.1.72+)
这些不是 OrchestKit 技能,而是 Claude Code 内置命令:
| 命令 | 描述 | 起始版本 |
|---|---|---|
/code-review | 按所选工作量级别检查变更代码中的正确性问题;--comment 会发布行内 PR 评论(在 2.1.146 中由 /simplify 更名而来;旧版的清理和修复行为已移除) | CC 2.1.146 |
/help | Claude Code 内置帮助 | CC 2.1.0+ |
/config | Claude Code 配置 | CC 2.1.0+ |
/clear | 清除对话(保留后台 Agent) | CC 2.1.72 |
/fast | 切换快速模式(使用相同模型,更快输出) | CC 2.1.59+ |
/loop | 定期间隔(例如 /loop 5m /foo) | CC 2.1.71 |
/plan | 进入计划模式(CC 2.1.222 移除了 ultraplan 功能,因此 /ultraplan 和“使用 Ultraplan 优化”交接流程不再存在) | CC 2.1.72 |
/team-onboarding | 生成队友入门指南 | CC 2.1.101 |
/recap | 闲置后恢复会话上下文 | CC 2.1.108 |
/undo | /rewind 的别名 | CC 2.1.108 |
/skills | 原生技能选择器——输入文字即可筛选 | CC 2.1.121 |
/effort | 推理工作量——为技能设置 $CLAUDE_EFFORT 环境变量 | CC 2.1.72(环境变量自 2.1.120 起提供) |
/cd | 将会话移至新的工作目录,且不会破坏提示词缓存 | CC 2.1.169 |
--safe-mode | 启动时禁用所有自定义配置(用于排查问题的二分定位) | CC 2.1.169(标志/环境变量,不是斜杠命令) |
性能提示
ENABLE_PROMPT_CACHING_1H=1— 将提示词缓存 TTL 从 5 分钟延长至 1 小时。长时间会话使用多阶段技能(brainstorm、implement、cover)时可设置此变量。适用于 API key、Bedrock、Vertex、Foundry。/recap— 离开一段时间后恢复会话上下文。可配合 OrchestKit 的检查点恢复功能,用于恢复链路。
键盘快捷键
| 快捷键 | 操作 |
|---|---|
Ctrl+F | 在会话输出中查找 |
Esc | 取消 / 关闭 |
Shift+Enter | 在输入中换行 |
Ctrl+C | 取消操作 |
专业提示
你无需记住各种技能,只需自然地描述任务:
"I need to implement user login" → implement
"Show me the payment architecture" → explore
"Review PR 123" → review-pr
"Is this code good?" → assess
"Plan out the billing redesign" → visualize-plan
相关技能
/help— Claude Code 内置帮助doctor— OrchestKit 健康检查setup— 完整的入门向导