技能创造者专业版

人工智能 社区

技能解读

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

工作流程概述

根据用户所处的位置,在正确的阶段跳入:“我想为 X 创建一项技能”→ 从第 1 阶段开始“这是我的技能草稿,帮助我改进它”→ 从第 4 阶段开始“我的技能未正确触发”→ 从第 6 阶段开始“只要和我一起共鸣”→ 根据需要跳过阶段,保持灵活性

与用户沟通

技能创建器很容易被熟悉编码术语的人们使用。如果你还没有听说过(你怎么可能听说过,最近才开始),现在有一种趋势,Claude 的力量正在激励水管工打开他们的终端,父母和祖父母去谷歌搜索“如何安装 npm”。另一方面,大多数用户可能相当精通计算机。

采访与研究

在回答 5 个问题之后,主动询问边缘情况、输入/输出格式、示例文件、成功标准和依赖性。等到这部分解决之后再写测试提示。检查可用的 MCP - 如果对研究有用(搜索文档、查找类似技能、查找最佳实践),则通过子代理进行并行研究(如果可用),否则进行内联研究。

第二阶段:设计

在编写之前,请阅读: references/content-patterns.md — 应用已确认的模式结构 references/design_principles.md — 遵循的 5 个原则 references/patterns.md — 实现模式(config.json、陷阱、脚本重用等) 决定:

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

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

01
第一阶段:理解

此阶段使用反转模式——先询问,后构建。如果当前对话已包含用户想要捕获的工作流程(例如,“将其转化为技能”),请在询问之前先从对话历史记录中提取答案。一次提出一个问题,等待每个答案。在回答所有必填问题之前,请勿进入第 2 阶段。 Q1(必填):这个技能应该让克劳德做什么?

02
第二阶段:设计

在写作之前,请阅读: `references/content-patterns.md` — 应用已确认的模式结构 `references/design_principles.md` — 遵循的 5 个原则 `references/patterns.md` — 实现模式(config.json、陷阱、脚本重用等) 决定:

03
第三阶段:写入

根据访谈和设计决策,编写 SKILL.md。

04
第 1 步:在同一回合中生成所有跑动(带技能和底线)

对于每个测试用例,在同一回合中生成两个子代理 - 一个具有技能,一个没有技能。这很重要:不要先生成 with-skill 运行,然后再返回基线。立即启动所有内容,以便所有内容大约在同一时间完成。带技能运行:基线运行(相同的提示,但基线取决于上下文):创建新技能:根本没有技能。同样的提示,没有技能路径,保存到`without_skill/outputs/`。

05
第 2 步:在运行过程中,草拟断言

不要只是等待运行完成——您可以高效地利用这段时间。为每个测试用例起草定量断言并向用户解释。如果断言已存在于`evals/evals.json`中,请检查它们并解释它们检查的内容。好的断言是客观可验证的,并且具有描述性名称——它们应该在基准查看器中清晰地阅读,以便人们在浏览结果时立即了解每个断言检查的内容。主观技能(写作风格、设计质量)可以更好地进行定性评估——不要将断言强加于需要人类判断的事情上。

06
第 3 步:运行完成后,捕获计时数据

每个子代理任务完成后,您都会收到一条包含 `total_tokens` 和 `duration_ms` 的通知。立即将此数据保存到运行目录中的`timing.json`:这是捕获此数据的唯一机会 - 它来自任务通知,不会保留在其他地方。在每个通知到达时对其进行处理,而不是尝试对它们进行批处理。

07
第 4 步:评分、聚合并启动查看器

所有运行完成后: 对每次运行进行评分 — 生成一个评分器子代理(或内联评分),读取`agents/grader.md`并根据输出评估每个断言。将结果保存到每个运行目录中的`grading.json`。 grading.json 期望数组必须使用字段 `text`、`passed` 和 `evidence`(不是 `name`/`met`/`details` 或其他变体)——查看器取决于这些确切的字段名称。对于可以通过编程方式检查的断言,编写并运行脚本而不是盯着它——脚本更快、更可靠,并且可以在迭代中重用。

08
第 5 步:阅读反馈

当用户告诉您他们已经完成时,请阅读`feedback.json`:空反馈意味着用户认为一切都很好。将改进重点放在用户有具体投诉的测试用例上。完成后杀死查看服务器:

讨论

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