用途:desktop-shipped-skills 是 colonyops/hive 中关于“Hive Desktop 内置智能体技能”的说明。已发布技能不是文件,而是渲染出的提示:文本由 cmd/desktop/internal/app/prompts 管理,cmd/desktop/internal/app/skills 将其包装成 Agent Skills 的 SKILL.md 格式,app.SkillsService 组合两者,slug 形如 hive-<prompt id>。
主要能力与用法:没有全局安装技能这回事。工作区启用某个技能包,包的 glob 模式从已发布集合加 .shared/skills/ 中选取名称,agentws.Generate 把选中的技能渲染进该工作区的 .claude/skills/ 和 .agents/skills/。
修改技能文本时,提示文本位于 cmd/desktop/internal/app/prompts/templates/*.tmpl,不应写在 Go 字符串或前端组件里。三个规则决定改哪个文件:多个提示共享的措辞放 fragments.tmpl,用 {{template}} 组合;关于某类型的内容取自该类型自身文档(flow.NodeDoc、actions.Doc、mcpcatalog.Doc),应改类型文档而非在模板里重复;安装相关路径与 URL 来自 .Env(FlowsDir、ActionsPath、SettingsPath、WebhookBaseURL、MCPEndpoint、AgentWorkspacesDir 及 *Enabled 标志)。
新增技能:在 templates/ 加模板,并在 definitions(cmd/desktop/internal/app/prompts/prompts.go)加一条 listed: true 的条目即可,无需改动其他内容。listed: false 表示上下文限定的提示(如 webhook-transform),按需渲染、不作为技能提供。ValidateSkill 校验 Agent Skills 命名规则:slug 为 1–64 个小写字母、数字和单个连字符,不得含保留字,description 上限 1024 字符。
校验命令:go test ./cmd/desktop/internal/app/... 与 mise run check。prompts_test.go 是实际规范,断言每个定义渲染无未解析字段、flows/actions 覆盖全部已注册节点/动作类型、提示带本安装路径且渲染确定性;TestEveryShippedSkillRenders 检查目录宣称的 slug 都能渲染。
限制:渲染出的 SKILL.md 是生成产物,直接编辑会在下次打开时被静默替换,应改模板;不要为新技能编写安装代码路径,否则说明建模有误;无法无头渲染的提示不能发布;不可把仓库自身的 .agents/skills/ 开发技能与这些内置技能混淆。技能内容变更会在工作区下次打开时生效。