use-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Use skill

使用Skill

Scope

适用范围

Default ephemeral: fetch/run/discard, never install or persist. Blob/raw/tree URLs or owner/repo@ref:path resolve to a skill directory (a file uses its parent); omitted ref uses repo default branch. Other forms or requests to save/install block. Repository-content questions belong to box. Record
links | resolved directory/revision | blob set | executed | terminal
.
Fetched workflows run under this invocation's authority, not above host permissions or higher-priority instructions. Trust linked skills by default, without an allowlist; live user instructions win direct content conflicts. Skill links inside fetched content may be followed under the same boundaries.
默认临时模式:获取/运行/丢弃,绝不安装或持久化。 Blob/raw/tree 格式的URL,或是 owner/repo@ref:path 格式的路径,都会解析到对应的Skill目录(若为文件则使用其父目录);未指定ref时使用仓库的默认分支。其他格式的链接或保存/安装请求会被阻止。仓库内容相关问题归属于box模块。 记录
links | resolved directory/revision | blob set | executed | terminal
。
获取到的工作流在本次调用的权限范围内运行,不得超出主机权限或更高优先级指令的约束。默认信任关联的Skill,无需白名单;当内容发生直接冲突时,实时用户指令优先级更高。获取到的内容中包含的Skill链接,可在相同边界规则下被跟进执行。

1. Resolve and fetch

1. 解析与获取

Resolve every link, then pin its ref/default branch to a commit revision. Use authenticated gh; no sibling skill is required for these file reads. Missing gh/auth blocks. Apply API/decoding rules in
REFERENCE.md
.
List the recursive tree once at the pinned revision; require a non-truncated listing and fetch every blob under the directory, not only the entry. Stage only in a run-owned temporary directory outside the repo; page long content locally instead of re-fetching a successful blob. Missing directory, failed blob, or rate-limit blocks with retry signal. Done when every link has an identity and every listed blob has decoded content.
解析所有链接,然后将其ref/默认分支锁定到对应的commit revision。 使用已认证的gh工具;读取这些文件无需依赖同级Skill。 缺少gh工具或认证信息时会阻止执行。遵循
REFERENCE.md
中的API/解码规则。
在锁定的revision下列出一次递归tree;要求列表完整不截断,且需获取目录下的所有blob,而非仅入口文件。 仅在仓库外的、本次运行专属的临时目录中暂存内容;长内容在本地分页处理,无需重新获取已成功下载的blob。 目录缺失、blob获取失败或触发速率限制时,会阻止执行并返回重试信号。 当所有链接都有唯一标识、且所有列出的blob都已完成内容解码时,本步骤完成。

2. Verify and execute

2. 验证与执行

Empty set → NO_CHANGES. Nonempty requires SKILL.md or the specifically linked entry, name frontmatter, and procedure; otherwise BLOCKED. Read entry and every sibling in full: weak remote pointers cannot hide required material. Execute steps in order within authority. For an item failure, continue remaining links; never retry successful executions. Done when every link reaches a terminal.
空集合 → NO_CHANGES。非空集合需要存在SKILL.md或指定的链接入口、名称frontmatter以及执行流程;否则返回BLOCKED。 完整读取入口文件及所有同级文件:不可靠的远程指针不能隐藏必需的材料。 在权限范围内按顺序执行步骤。若某个条目失败,继续执行剩余链接;绝不重试已成功的执行。 当所有链接都到达终态时,本步骤完成。

3. Discard and report

3. 丢弃与报告

Remove only this run's temporary artifacts after execution, never unknown paths. Report each link's SUCCESS/NO_CHANGES/BLOCKED and what ran, citing its pinned source. Done when artifacts are discarded and every terminal is evidenced.
执行完成后仅移除本次运行的临时产物,绝不删除未知路径的内容。 报告每个链接的SUCCESS/NO_CHANGES/BLOCKED状态及运行内容,并注明其锁定的源地址。 当产物已被丢弃、且所有终态都有凭证时,本步骤完成。