用户级 Skills
Skill 是包含 SKILL.md 的指令目录。Arca 保留一份中央副本,通过链接分配给已核验的用户级 Agent 目录;只管理全局 Skills。
获取 Skill
| 来源 | 用法 |
|---|---|
| GitHub | 填写公开仓库或子目录 URL,按 Enter 或点击导入 |
| 本地文件夹 | 选择单个 Skill 或包含多个 Skill 的目录 |
| 压缩包 | 导入 .zip、.tar.gz、.tgz 或 .tar |
| Agent 中的外部副本 | 先只读观察,再显式导入准确副本 |
GitHub、本地文件夹与压缩包不需要 Git、Node.js 或 npx 来安装。下载和导入先进入中央库;让 Agent 使用它是之后单独的分配步骤。
提交来源后会直接导入找到的全部 Skills,不再打开安装风险确认页。只想导入某个 Skill 时填写它的子目录 URL。同名中央副本先备份再替换,已有分配与停用状态保持不变。路径、压缩包和候选内容校验仍由 Core 执行,导入不会运行脚本。
来源导航与卡片
左侧显示具体来源。相同 GitHub 仓库的不同子目录归在一起;同名但位置不同的本地目录保持独立。搜索作用于当前范围。
每张卡片展示名称、最多三行简介和可读取该 Skill 的 Agent 图标。图标像手中的扑克牌一样叠放,悬停或键盘聚焦展开;点击进入 Agent 的 Skills 页。详情展示中央内容与实际副本,外部副本不会继承中央副本的来源或风险结论。
分配、停用与解除使用
在 Agent 的 Skills 页选择中央 Skill。分配后,实际用户级目录中的链接指向:
~/.arca/assets/skills/items/<skill-name>/同一实际目录可能被多个 Agent 读取,计划会展示全部受影响的 Agent。停用保留关系与中央内容;解除使用保留中央资产,只移除可证明属于 Arca 的链接。
外部目录、普通文件和指向其他位置的链接不会被顺手删除。实际目标有多份时,CLI 的启停使用 --target <target-id> 精确选择。
更新与本地修改
检查更新只读取版本或内容状态,不改正文。普通低风险更新直接执行;覆盖本地修改、存在冲突或涉及高风险候选时才需要一次审阅。
重新安装、导入同名的中央资产和更新会保留既有消费关系与停用状态。上游 revision 变化而内容不变时,只更新版本元数据。采用外部内容会重新读取、审计并绑定当前内容哈希;审阅后文件改变会拒绝旧计划。
消费者使用的是同一份中央链接,所以修改受管链接下的文件也会改变中央内容。Arca 会检测这类变化,不把它误当成独立外部副本。
风险与恢复
Arca 校验路径、链接、压缩包、结构与内容哈希;不执行候选脚本。SKILL.md 以文本预览,不运行内嵌 HTML 或远程资源。
高风险内容的确认绑定准确哈希。已经确认的中央版本在之后分配、启用时不重复弹出相同风险确认;内容变化会重新审查。减权操作不会因为风险门禁被阻止。
中央状态先保存,各实际目标独立同步。失败目标保留待处理关系,已经完成的目标不回滚;可在详情中查看原因并修复。删除中央 Skill 会审阅消费者,并将中央内容移到带时间戳的备份。
当前边界
不支持项目级 Skill 写入、需认证的私有 Git 来源,或在 Arca 内直接创建 / 编辑 SKILL.md。目录契约与可写能力见 支持的 Agent。