技能创作

文档 社区

技能解读

当前原文的自动摘译,尚未人工审校。

目标

将嘈杂的步骤跟踪或草稿降价转换为严格的SKILL.md,即:确定性地执行明确的关于何时触发明确的失败处理对严格的技能验证规则有效

所需结构

Frontmatter:name(kebab-case,匹配目录)description(一个简洁的句子)可选的metadata用于触发器/需求的 JSON 正文部分:

细化规则

尽可能用语义 UI 目标替换脆弱的坐标。使每个过程步骤保持一个原子操作。为常见拦截器添加至少一种后备路径(身份验证墙、空状态、加载超时)。如果需要个人数据,请在 UI 操作之前添加request_human_auth 指导。保持语言简洁且可执行。

验证门

晋升前:进行严格的技能验证。如果验证失败,请保留草稿并报告问题。仅推广经过验证的输出。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
文档
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@pockebot · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# skill-authoring

Use this skill when converting a rough draft into a production-ready skill document.

## Goal

Transform noisy step traces or draft markdown into a strict `SKILL.md` that is:

1. deterministic to execute
2. explicit about when to trigger
3. explicit about failure handling
4. valid against strict skill validation rules

## Required Structure

1. Frontmatter:
   - `name` (kebab-case, matches directory)
   - `description` (one concise sentence)
   - optional `metadata` JSON for triggers/requirements
2. Body sections:
   - `When To Use`
   - `Preconditions`
   - `Procedure`
   - `Failure Handling`
   - `Completion Criteria`

## Refinement Rules

1. Replace fragile coordinates with semantic UI targets whenever possible.
2. Keep each procedure step one atomic action.
3. Add at least one fallback path for common blockers (auth wall, empty state, loading timeout).
4. If personal data is required, add `request_human_auth` guidance before UI actions.
5. Keep language concise and executable.

## Validation Gate

Before promotion:

1. Run strict skill validation.
2. If validation fails, keep as draft and report issues.
3. Promote only validated output.

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。