用途
local-skills-setup 是一个引导式向导,用于设置和管理本地学习到的技能(skills)。技能是可复用的问题解决模式,当 Claude 检测到匹配的触发条件时会自动应用。该技能帮助用户捕获针对自身代码库或工作流的经验与解决方案,并将其保存为可被自动匹配和调用的本地技能。
主要能力
- 目录检查与创建:检查并创建用户级技能目录(~/.claude/skills/omc-learned/)和项目级技能目录(.omc/skills/)。
- 技能扫描与清单:扫描两个目录,统计并列出技能数量、名称、描述和修改时间。
- 详细技能清单:展示每个技能的触发关键词(triggers)、质量(quality)、位置、文件名和最后修改时间。
- 对话模式扫描:分析当前对话上下文,识别值得沉淀为技能的模式,例如近期调试会话中的非显而易见解决方案、棘手的 bug、代码库特定的变通方法、耗时较长的错误模式。
- 导入技能:支持从 URL(如 GitHub gist)下载技能,或直接粘贴技能 markdown 内容,并选择保存到用户级或项目级目录。
- 技能模板:提供错误解决方案、工作流、代码模式、集成等常见技能类型的起始模板。
- 质量指南:提醒用户好技能应具备不可通过搜索轻易获得、上下文特定、精确可操作、来之不易等特征。
使用方式
交互模式
不带参数调用时,运行完整的引导向导(步骤 1-4):
- 目录检查与设置:检查并创建用户级和项目级技能目录。
- 技能扫描与清单:扫描两个目录并展示综合清单。
- 快速操作菜单:通过 AskUserQuestion 工具提供选项——添加新技能、列出所有技能详情、扫描对话中的模式、导入技能、完成。
- 技能模板:提供常见技能类型的快速模板。
直接命令模式
带参数调用时跳过交互向导:
- /oh-my-claudecode:local-skills-setup list - 显示详细技能清单
- /oh-my-claudecode:local-skills-setup add - 开始技能创建(调用 learner)
- /oh-my-claudecode:local-skills-setup scan - 扫描两个技能目录
相关技能
- /oh-my-claudecode:learner - 从当前对话中提取技能
- /oh-my-claudecode:note - 保存快速笔记(比技能更非正式)
- /oh-my-claudecode:deepinit - 生成 AGENTS.md 代码库层级
适用场景
- 解决棘手 bug 或发现非显而易见的变通方法后,将其提取为技能,供未来对话自动检测和应用。
- 需要将代码库特定的知识(如自定义路径解析、特定错误修复)随仓库进行版本控制,让整个团队受益。
- 需要跨所有项目复用通用模式时,使用用户级技能。
- 需要从当前对话中识别并沉淀值得保存的问题解决模式。
- 需要从外部来源(URL 或粘贴内容)导入已有技能。
限制
- 该技能依赖 Claude 的 Skill 工具和 AskUserQuestion 工具,以及本地文件系统目录结构。
- 技能质量取决于用户提供的上下文和触发条件的准确性;需要随时间审查和优化触发条件以提高匹配精度。
- 资料未提供关于收费、价格、平台兼容性、具体效果或性能的说明。
- 资料未提供安装命令或依赖要求。