技能与插件
技能
技能是智能体可按需加载的 markdown 剧本 —— 指令、模板,可附带脚本。技能采用渐进披露:系统提示里只放名称 + 描述;完整剧本只在被调用时加载(你经 /skill,或模型识别到匹配任务时经 Skill 工具)。
分层(装完能用什么)
| 层 | 位置 | 如何获得 |
|---|---|---|
| L0 — 二进制内嵌 | 编进 binary | 始终可用:团队 rubrics(evaluation-rubric、optimization-rubric、team-design-rubric) + 薄版 docx 兜底 |
| L1 — 默认技能包 | 发布包内 default-skills/,同步到 ~/.hipmmcode/skills/ | 文档 + 设计基础包(见下)。npm / install.sh / 首次启动自动装,也可手动 |
| L2 — 用户 / 项目 / Claude | ~/.hipmmcode/skills/、项目 .hipmmcode/skills/、以及(兼容时) ~/.claude/skills/ | 自己安装、仓库技能、Claude Code 导入 |
加载优先级:用户/项目(与 legion)优先于 L1;L0 只补磁盘上还没有的名字。
默认技能包(L1)
自 v0.14.1 起,发布 tarball 自带 默认技能包(文档 + 设计),新装即可用,不必先 clone 第三方 skill 仓库。
| 类别 | 技能 |
|---|---|
| 文档 | docx、pptx、xlsx、pdf |
| 设计 | frontend-design、canvas-design、theme-factory、brand-guidelines |
| 自举 | skill-creator |
如何统一安装(各渠道同一路径)
发布包 / npm 解压
hipmmcode (可执行文件)
default-skills/ (L1: MANIFEST.toml + 各技能目录)
│
▼ 首次启动 或 `hipmmcode skill install-defaults`
~/.hipmmcode/skills/<name>/
│
▼ load_skills()| 渠道 | 何时同步 L1 |
|---|---|
npm @hipmmai/hipmmcode | postinstall 执行 skill install-defaults |
| install.sh(curl) | 安装结束后同一命令 |
| 任意能看到 pack 的二进制首次启动 | 静默缺啥补啥 |
| 手动 | hipmmcode skill install-defaults |
手动安装 / 修复
hipmmcode skill install-defaults # 仅补缺失;可重复执行
hipmmcode skill defaults # 别名
hipmmcode skill install-defaults --force # 强制覆盖(含用户自改的同名目录)
hipmmcode skill install-defaults --dry-run
hipmmcode skills # 列出已发现技能覆盖规则
| 目标目录 | 行为 |
|---|---|
| 没有该技能 | 从 pack 安装 |
带 .hipmmcode-default-pack 标记 | pack 版本更新时升级 |
| 无标记(你自己装/改的) | 跳过(除非 --force) |
若提示找不到 pack
二进制按以下顺序查找:
- 环境变量
HIPMMCODE_DEFAULT_SKILLS_DIR {可执行文件目录}/default-skills/(发布包 / npm 布局){可执行文件目录}/../share/hipmmcode/default-skills/(Homebrew 风格)- 开发时:源码树
crates/sc-skills/default-pack
export HIPMMCODE_DEFAULT_SKILLS_DIR=/path/to/default-skills
hipmmcode skill install-defaults手动解压发布包时请保留 default-skills/ 与 hipmmcode 同级,不要只拷贝二进制。
安装更多技能
hipmmcode skill add anthropics/skills # GitHub 仓库(owner/repo 或完整 URL)
hipmmcode skill add QianWen-AI/qianwen-ai # 千问官方 AI 技能包
hipmmcode skill add https://…/SKILL.md # 原始 markdown URL
hipmmcode skill add ./my-skill # 本地路径
hipmmcode skill add owner/repo --name docx # 覆盖安装名
hipmmcode skill list
hipmmcode skill rm theme-factory自定义技能落在 ~/.hipmmcode/skills/。仓库可以是单技能(根 SKILL.md)或多技能(skills/ 目录)。skills/image/<技能>/SKILL.md 这类分类式多层仓库会被递归发现；识别到技能根目录后，其 references 与 scripts 会完整保留在该技能内，不会被误装成其他技能。
千问官方包的执行脚本是独立的按量付费工作流，需要通过 DASHSCOPE_API_KEY 或 QIANWEN_API_KEY 提供普通 sk-...，不会消费 hipmmcode model 保存的渠道凭据。在直连 qwen-token-plan 与 qwen-token-plan-anthropic 渠道上，原生 GenerateImage、GenerateVideo 和 GenerateSpeech 会改为通过各自的多模态专用端点复用已配置的 Token Plan sk-sp-...，不需要 Skill。
使用
| 界面 | 行为 |
|---|---|
/skills | 交互菜单 —— 一行一个技能,Enter 看详情 |
/skill <name> [args] | 立即把技能剧本载入对话 |
Skill 工具 | 模型自己调用匹配的技能 |
/reload-skills(/reload) | 不重启重扫磁盘 |
claudeCodeCompat=true(或 /compat on)时,还会从 ~/.claude/skills/ 与项目 .claude/skills/ 发现技能。
发现顺序(细节)
- 激活的 legion
…/legions/<名>/skills/(若有) - 项目
.hipmmcode/skills/ - 用户
~/.hipmmcode/skills/(L1 + 你的 add) - Claude 兼容
.claude/skills/(用户 + 项目,开启时) - 插件
- L0 二进制兜底
自定义斜杠命令
.hipmmcode/commands/ 或 .claude/commands/(项目或家目录)里的每个 markdown 文件都会成为 REPL 的 /<name> 命令 —— 文件正文即提示模板。子目录命名空间化:commands/deploy/staging.md → /deploy:staging。
hipmmcode commands # 列出已发现的模板支持参数插值和 !`cmd` shell 插值(组织级可用 disableSkillShellExecution 策略关闭)。
/alias 再叠加个人简写:/alias co=code-review。
输出风格
/output-style 切换智能体的写作方式(简洁 / 讲解 / 教学,以及你的自定义 markdown 风格文件)。经 outputStyle 持久化。
插件
插件把命令、智能体、技能、hooks 与 MCP 服务器打包为一个可安装单元。
hipmmcode plugin list # 已发现插件 + 各自贡献
hipmmcode plugin details <name> # 组件 + 磁盘位置
hipmmcode plugin add ./my-plugin # 从本地路径安装
hipmmcode plugin init my-plugin # 脚手架一个新插件
hipmmcode plugin enable|disable <id> # 不卸载地启停
hipmmcode plugin uninstall name@marketplaceREPL 里:/plugins 列出已装插件及其贡献。
市场
hipmmcode plugin marketplace add owner/repo # 注册(仓库、URL、marketplace.json 或本地路径)
hipmmcode plugin marketplace list
hipmmcode plugin install name@marketplace # --scope user|project|local
hipmmcode plugin marketplace remove <name>每次安装都显示信任标签 —— official、local 或 third-party —— 第三方来源附带提醒,让你一眼看清即将运行的代码来自哪里。官方插件的重名抢注会被阻止。