Multica 提及与委派技巧
通过构造正确的提及链接,将任务无缝委派给智能体、小队或广播给所有人。
证据显示技能精确描述提及机制,并明确界定权限边界,例如invoke gate与see gate的区分、同一reason_code避免存在性泄露、自动代理授权的溯源限制。但技能本身仅提供Bash(multica *)工具,未指明用户确认步骤或数据流透明度;它代表代理执行操作,可能造成外部影响(触发任务),但未提及回滚或恢复机制。扣分因为缺少明确的用户确认和回滚方案。
技能依赖source map提供文件:行证据,CLI命令明确,自我一致性高。关键路径(解析、触发、抑制)有Go测试覆盖(如TestMentioningSkillTeachesTheParserContract),但静态审查无法复现执行。错误处理描述清晰,但依赖外部CLI可用性,未验证。因静态审查限制给的满分不超过10。
技能明确说明适用场景:需要提及某人时;并有效界定非适用情况(项目引用、成员提及不触发运行)。触发条件清晰(提及格式精确匹配),避免误触发。然而,环境适配方面,技能要求访问托管平台(multica.ai),可能在中国大陆网络受限;技能本身英文编写,未提供中文版本,中国用户可能需自行翻译。扣分因为环境适配证据有限。
文档层级清晰:SKILL.md提供概要,source map提供详细证据,命名规则一致。未提及版本或变更日志,但CI工作流存在。许可证是NOASSERTION,但有自定义的Multica License,其条款可能影响技能使用。发布者未验证,但维护责任在README中明确。扣分因为许可证不标准且版本化不明确。
技能的目标(生成正确的提及链接)明确,且提供正确/错误示例,输出可直接使用。相比手动查UUID并构造链接,节省时间。但静态审查无法验证实际效果;技能未提供基准或替代方案对比。因此上限7。
技能提供source map,引用具体文件:行,并引用多个测试文件(如mention_test.go、comment_trigger_preview_test.go),这些构成可审计的主证据。CI配置文件显示测试套件存在。但静态审查未执行任何测试,无法独立复现;测试覆盖范围有限(仅部分关键路径)。因此上限5。
- 该技能仅适用于 Multica 平台,若核心功能依赖海外服务,在中国大陆网络环境下可能不可达。
- 许可证为 NOASSERTION,自定义Multica License的附加条款可能影响技能的分发与使用,请在使用前仔细审查。
- 技能未提供用户确认步骤,可能自动触发代理任务,需确保代理运行环境安全。
这个 Skill 能做什么,适合哪些场景?
Multica 的"提及与委派"技巧指导如何构造提及链接(mention links),以在 Multica 平台中触发智能体或小队执行任务。它强调必须使用真实 UUID 而非显示名称来构造链接,并详细解释了不同的提及类型(agent、squad、member、issue)和 @all 广播的行为差异。该技巧基于源代码和测试用例确保准确性,并提供了逐步的查找 UUID 的方法。
该技巧读取 Multica 命令行界面(CLI)的命令来查找成员、智能体和小队的 UUID,然后构造形如 [@Label](mention://type/uuid) 的提及链接。它区分了哪些提及会触发新任务(agent 和 squad),哪些仅渲染链接(member 和 issue),并解释了 @all 广播以及提及失败时的行为(如 coalesced、deferred、blocked 等状态码)。
- 一位项目经理想要将一个问题指派给特定智能体,通过提及该智能体来触发它的运行。
- 一个小队领导需要将工作交给整个小队,通过提及 squad 让队长智能体负责分发。
- 在评论中提醒某位人类成员注意某个问题,但不希望触发任何自动任务。
- 引用一个问题作为上下文,而不会启动任何新的运行。
- 在评论中广播 @all 通知所有人,同时抑制对问题负责人的自动触发。
这个 Skill 有哪些优点和局限?
- 详细且基于源代码,确保准确性
- 明确区分了会触发任务和仅渲染链接的提及类型
- 提供了失败情况的详细解释,帮助调试
- 支持团队内的自动化和委派
- 与 Multica 平台紧密集成,提供统一的工作流
- 仅适用于 Multica 平台,没有通用性
- 需要用户熟悉 UUID 查找,门槛较高
- 提及失败时不会返回错误响应,只能靠 trigger_outcomes 数组来判断
- 没有提供独立的测试套件,依赖上游的 Go 测试
如何安装这个 Skill?
该技巧随 Multica 仓库一起分发,路径为 server/internal/service/builtin_skills/multica-mentioning/SKILL.md。要使用它,你需要先安装 Multica CLI(通过 Homebrew 或安装脚本),并完成设置。关于如何将技巧添加到智能体环境的详细步骤未在来源中明确说明。
如何使用这个 Skill?
- 使用 CLI 查询成员、智能体或小队的 UUID,例如
multica workspace member list --output json获取成员的 user_id。2. 根据目标类型构造提及链接:[@Name](mention://agent/<uuid>)触发智能体,[@Name](mention://squad/<uuid>)触发小队队长,[@Name](mention://member/<user_id>)仅链接,[@Name](mention://issue/<uuid>)仅引用。3. 在评论中使用上述链接,并注意 @all 的特殊用法。