use-skill
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseUse 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 | terminalFetched 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.mdList 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工具或认证信息时会阻止执行。遵循中的API/解码规则。
REFERENCE.md在锁定的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状态及运行内容,并注明其锁定的源地址。
当产物已被丢弃、且所有终态都有凭证时,本步骤完成。