用途:按 agentskills.io 规范与渐进式披露原则生成智能体技能,适用于新建技能目录、起草流程性指令等场景。
主要能力与用法: 一、初始化并校验元数据。名称限 1-64 字符,仅小写字母、数字和单个连字符;描述最长 1024 字符,用第三人称并包含否定触发条件。运行校验脚本:python scripts/validate-metadata.py --name "[name]" --description "[description]"。若报错,依据 stderr 自行修正元数据后重跑,直至通过。 二、组织结构。用校验后的名称创建根目录,并初始化子目录:scripts/(小型 CLI 工具与确定性逻辑)、references/(一层深度的扁平上下文,如 schema 或 API 文档)、assets/(输出模板、JSON schema 或静态文件)。不创建 README.md、INSTALLATION.md 等面向人类的文件。 三、撰写核心逻辑 SKILL.md。以 assets/SKILL.template.md 为起点,全部指令用第三人称祈使句。强制渐进式披露:主逻辑保持在 500 行以内;大型 schema 或复杂规则集移入 references/,并让智能体仅在需要时读取,例如“Read references/api-spec.md to identify the correct endpoint.” 四、识别并打包脚本。找出脆弱任务(正则、复杂解析、重复样板),为 scripts/ 编写单一用途脚本,用标准输出 stdout/stderr 向智能体报告成功或失败。 五、最终校验。检查 SKILL.md 中迫使智能体猜测的“幻觉缺口”;确认所有文件路径为相对路径并使用正斜杠;最后对照 references/checklist.md 交叉核对输出。
错误处理:元数据失败时定位具体错误(如“STYLE ERROR”),去除第一/第二人称后重写字段;上下文膨胀时,若草稿超过 500 行,将最大的流程块移至 references/。
限制:资料未说明该技能的具体收费、价格、支持平台或运行环境,暂未提供。