mcpField
H
help

help

github.com/yonatangrossAgent 工作流300160 次安装今天更新
代码仓库

关于 help

help 是 OrchestKit 的技能浏览工具,可按类别查看已安装技能或列出所有可由用户调用的技能。它会在运行时发现技能,避免依赖过时的固定列表。

主要功能

  1. 01运行时发现已安装技能
  2. 02按类别浏览技能
  3. 03列出所有用户可调用技能
  4. 04说明技能适用原因

适用场景

  1. 01浏览 BUILD 或 GIT 技能
  2. 02为任务查找相关技能
  3. 03查看所有可调用技能

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yonatangross/orchestkit --skill help

安装后在 Claude Code 中输入/help确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

test-cases.json
references/
cc-keyboard-shortcuts.md
rules/
_sections.md
skill-metadata-freshness.md
category-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 参数匹配以下任意标签
BUILDbuildimplementation, feature, testing, coverage, test-generation, verification, e2e
GITgitgit, github, commit, pull-request, pr, issue, bug-fix
PLANplanplanning, ideation, prd, requirements, visualization
QUALITYqualityquality, assessment, evaluation, code-review, validation, grading
MEMORYmemorymemory, decisions, graph-memory, consolidation
CONFIGconfigsetup, configuration, onboarding, diagnostics, health-check, dev-loop
EXPLOREexploreexploration, codebase, code-search, architecture, discovery
DESIGNdesigndesign, design-context, design-tokens, design-to-code, frontend, ui, components, stylecards
OPSopsci, 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
/helpClaude Code 内置帮助CC 2.1.0+
/configClaude 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 — 完整的入门向导

评论

支持 Markdown