CODEX / SKILLS EXPLAINED
SOURCE · 8f195c93
Metadata · Instructions · Resources · Actions

AI Skills 是如何工作的?

从一条技能摘要,到一套可复用的工作方法。看清 Codex 怎样找到 Skill、读懂说明,再把它用于当前任务。

一句话:Skill 是按需加载的工作说明书,不是自动执行的程序。

节点独立配色选中时同色加强 · 说明同步

适合电脑或大屏

100%
From Discovery to Delivery
Ctrl/⌘ + 滚轮缩放 · 普通滚轮滚动页面 · 拖动节点或背景 · 点击查看源码与边界
正在展开 Skills 工作机制…
01 / 09运行全程

渐进披露:摘要 → 完整指令 → 相关资源能力边界:加载 Skill 不会自动安装工具或提升权限交互演示:播放只改变高亮,不会运行脚本
A SMALL, REUSABLE WORKFLOW

一个 Skill 可以有多简单?

“任务实例”视图使用下方虚构技能。它只约定工作方法,不是当前环境里已安装的技能。

展开 release-brief / SKILL.md 教学样例
---
name: release-brief
description: 将代码仓库的指定范围变更整理成一页发布简报;不负责发布或部署。
---

1. 确认仓库与版本范围;缺失时先询问用户。
2. 读取 references/editorial.md,确认分类口径。
3. 用已有只读工具查看提交与变更,不修改代码。
4. 按 assets/brief-template.md 组织简报。
5. 核对每项结论对应的提交或变更依据。
6. 输出简报与来源;不自动部署或对外发送。

支持资源:
  references/editorial.md   分类与措辞规则
  assets/brief-template.md  交付模板
  scripts/                 本例不需要
怎么判断这个 Skill 写得是否有效?

分别测试应该触发、不应触发、缺少输入和执行失败的请求。匹配错了先检查 description;匹配对但结果不稳定,再检查正文步骤、验证条件与资源说明。

COMMON MISCONCEPTIONS

四个容易混淆的地方

安装后,每次都会加载全部内容吗?

不会。初始目录主要提供元信息;选中后才加载说明,引用材料按任务需要读取。宿主扫描磁盘时解析过文件,不等于模型已经看过全文。

使用 Skill,就是调用一个同名工具吗?

不是。显式 Host Skill 可能由运行时注入说明,也可能通过文件或资源读取工具访问;之后才按需要执行其他工具动作。不能把一种读取实现当成统一协议。

scripts/ 里有脚本,就会自动运行吗?

不会。需要模型判断是否适用,再通过实际执行工具启动。只需要指令的任务可以不调用工具;有 scripts/ 也不代表每次都应运行。

说明里写了某个工具,就能直接用了?

不能。工具还必须已连接、可用并具备相应授权。缺少工具、输入或权限时,应说明限制,按实际边界继续或向用户询问;Skill 不能绕过约束。