Multica 代理创建技能
通过 CLI 或 API 创建、检查和调试 Multica 代理定义,而无需手动拼写 JSON。
基于技能文档和源码映射,技能对敏感数据(custom_env、mcp_config)提供了明确的处理方式(不回显明文、支持stdin/file输入、有审计记录),并对副作用操作(create、copy、skills set/add、env set)明确要求显式指令而非推测执行。这显示了良好的最小权限和数据流透明度。扣分原因:来源身份未验证(发布者未知),且无法从静态阅读确认实现是否完全符合文档中描述的权限控制;对回滚和彻底的数据隔离的验证不足。满分25分需全面证据,此处证据尚不充分,故扣除。
技能文档编写高度自洽,提供了详细的字段契约与错误处理说明(如description上限、concurrency 1-50验证、thinking_level的运行时能力区分),并包含关键路径的源码位置引用。扣分原因:本评审为静态阅读,未实际执行任何命令或测试,无法验证CLI行为、错误输出或文档中引用的测试是否存在且通过。文档虽有源码映射,但未包含实际测试结果或日志证据,可靠性上限无法达到更高。
技能明确定义了适用场景(创建、检查、调试agent定义)和排除场景(分配已存在agent的任务),description清晰,并说明了非适用边界。扣分原因:作为一款面向全球的开源工具,未提及对大陆网络环境的适配性;若核心功能依赖海外服务(如GitHub、官方云),则存在可达性问题。文档未明确支持中文限制,但多语言文档(README有中文版)表明有一定国际兼容性。整体适用性良好,但环境适配证据有限。
技能遵循了良好的信息架构(从快速开始到详细字段契约),提供了清晰的安装/依赖说明(引用源码和验证命令),并明确列出了函数参数含义、已知限制和常见错误假设。扣分原因:文档来源明确(有源码映射),但未提供版本号或变更日志,维护责任不明确(发布者身份未知),且许可证元数据为NOASSERTION,需要用户自行核实授权条款。
技能准确描述了agent创建的完整流程,包括关键字段差异和副作用操作,能够帮助用户避免常见错误,具有明确的边际价值(如区分description和instructions)。扣分原因:静态阅读无法验证命令是否真实运行成功,文档中虽有源码引用,但未提供实际执行的输出或用户验证案例;输出结果(如创建后的agent记录)的格式和可用性未通过实际测试确认,因此无法给出更高的有效性评分。
技能提供了详细的源码映射文件(references/creating-agents-source-map.md),每个契约都有file:line引用,并附录了验证命令(go test运行特定测试)。这提供了可追溯的证据。扣分原因:本评审为静态阅读,未实际执行测试或验证源码位置;仓库中虽有CI工作流和测试文件,但未在提供材料中展示测试结果;所有证据均为单一来源(同一仓库),缺乏交叉验证。根据静态校准规则,最高只能给到5分。
- 此技能依赖Multica CLI和服务端,核心功能(如创建agent)可能依赖于GitHub或官方云基础设施,在大陆网络下可能无法直接访问,请确认网络可达性。
- 发布者身份未验证,许可证标注为NOASSERTION,请自行核实授权条款和法律责任。
- 文档声称有源码映射和测试,但未提供实际测试结果,静态评估无法验证命令行为,请在实际环境中先行测试。
这个 Skill 能做什么,适合哪些场景?
此技能提供 Multica 代理创建路径的权威指南:create 端点接受什么、服务器验证和拒绝什么、每个字段如何持久化、守护进程在声明时读取什么。它澄清了 description 和 instructions 之间的区别,并记录了所有字段合同,包括 secrets 处理、技能绑定和复制。有关 Multica CLI 和 API 的精确操作细节,请参阅它。
读取 multica CLI 命令和 POST /api/agents 端点。提供 multica agent create、copy、get、skills add/list/set、env get/set 的精确命令。解释字段语义:description 与 instructions、环境变量和 mcp_config 的秘密通道、skill_ids 绑定行为以及 max_concurrent_tasks 验证。涵盖代理行为契约的常见错误假设。
- 通过 `multica agent create` 创建具有正确字段的新代理,并希望设置正确的 instructions 而不是 description。
- 负责排查为什么代理没有遵循预期行为 — 用户需要检查 `instructions` 是否被正确设置。
- 需要安全地为代理设置环境变量,而无需将秘密泄露到 shell 历史中 — 使用 `--custom-env-stdin` 或 `--custom-env-file`。
- 需要将技能绑定到新代理 — 知道 `add` 和 `set` 不是可互换的。
- 从现有代理复制配置,包括技能绑定,而无需手动重新创建它们。
这个 Skill 有哪些优点和局限?
- 提供每个字段的精确的、可追溯的文档,以及 `file:line` 引用。
- 包含实际可用的 CLI 命令,包括安全的 secrets 处理。
- 明确区分 `description` 和 `instructions`,避免常见陷阱。
- 涵盖 `copy` 和 `skills` 命令,这些在官方文档中常常被忽略。
- 仅适用于 Multica 平台 — 不能用于其他代理编排器。
- 需要安装 Multica CLI 和可访问的 Multica 服务器或云。
- 不涵盖代理运行时本身(例如 Claude Code 或 Codex)的配置 — 仅涵盖 Multica 层。
如何安装这个 Skill?
此技能包含在 Multica 开源仓库中,作为内置技能。您需要安装 Multica CLI(例如通过 Homebrew:brew install multica-ai/tap/multica),并确保您的环境中可用。
如何使用这个 Skill?
在支持 Agent Skills 的客户端中,通过仓库中 SKILL.md 的身份调用此技能。技能会指导您使用 multica agent 命令。示例:multica agent create --name my-agent --runtime-id runtime-123 --description "摘要" --instructions "您的行为合同"。当需要创建、检查或调试代理时,提示模型使用此技能。