SuperAPI AI 工具集

skill-writer

通用与其它

查看项目

更新于 10-16 04:32

技能介绍

用途:Skill Writer 用于创建或修订可移植的 Agent Skill,只有在用户审阅并批准确切内容后才写入文件。

主要能力与规则:每次运行都检查 https://agentskills.io/specification,并以该规范为准,优先于记忆、示例、客户端宽容度和本技能自身;若无法检查规范,可继续做发现工作,但不得写入或修改技能文件。遵循严格的跨客户端规范,仅在用户要求时添加客户端特定行为并在批准草案中标注。先检查已提供材料、仓库上下文和现有技能文件,再提问。仅在仍有实质缺口时重复“精炼→研究→提问”循环。写入前展示完整拟议文件树及每个新增或修改文件的完整内容,并要求用户明确批准;修订、讨论或回答问题不算批准。若批准内容之后发生变化,需重新展示并再次获批。只写入批准草案中包含的文件。

子代理:在循环开始时检查子代理是否可用并查看其角色;可用于有界独立工作,如检查仓库不同区域、研究独立外部问题、识别歧义与候选问题、审查规范符合性与可移植性。每个子代理分配不同任务,优先并行只读研究或审查,保持单一父级写入路径;不要无意义扇出、委派竞争草案或让普通子代理再编排子代理。子代理可返回发现和建议问题,但父代理必须综合结果、提出建议、就重要决策询问用户并获取最终批准。

工作流:捕获想法(能力与预期结果、触发短语与上下文、输入输出、工作流或决策点、目标用户与支持客户端、工具依赖与环境约束、安全隐私或权限边界、成功与失败示例、新建还是修订);检查可用上下文(目标仓库、邻近技能、约定、已安装工具、相关源文件,复用合适模式,不访问凭据或无关私有数据);验证当前规范(获取并阅读规范,记录影响拟议技能的要求,至少核对技能目录与 SKILL.md、必需与可选 frontmatter、名称与目录匹配、description 约束、正文与渐进披露指引、资源目录与文件引用、验证);研究实质未知项(仅研究可能改变行为、结构、指令、依赖、安全或用户选择的事实,优先官方文档与一手来源,保留来源链接);精炼工作简报;提出聚焦问题(每轮 2–5 个相关问题,优先具体选项并附建议,优先行为、范围、输出、触发、安全、依赖与可移植性);起草技能(使用祈使、直接语言,应用渐进披露,frontmatter description 足够具体以正确触发,SKILL.md 保持聚焦,详细材料移入直接引用的资源,引用保持浅层且相对技能根目录,仅为确定性或重复实现的工作包含脚本,不添加推测性抽象、依赖、文件或配置);展示批准草案(规范 URL 及是否成功检查、最终工作简报、拟议文件树、每个新增或修改文件的完整内容、需删除文件、验证计划、客户端特定扩展或未解决风险,并让用户选择批准并写入、修订、回答剩余问题或取消);获批后只写入批准路径,修改前再次读取现有目标文件,保留无关内容,不静默改进或扩展草案,若冲突需不同内容则停止并重新确认;验证(目录名等于 frontmatter name、必需 frontmatter 存在且满足当前约束、可选 frontmatter 使用支持的类型与限制、SKILL.md 与引用资源路径存在、引用为相对路径且符合当前深度指引、主文件符合渐进披露指引、未写入未批准文件;可用现成兼容验证器,官方 skills-ref 库可作参考检查但非生产工具,未经用户批准不得仅为该检查安装验证器或添加项目依赖;若验证需要内容变更,展示确切修正并在编辑前获批)。

完成时报告:写入或修改的路径、检查的规范 URL、执行的验证及结果、任何剩余警告或可移植性限制。除非用户另行要求,编写技能时不要实现该技能的主题任务。

限制:资料未提供具体价格、平台支持列表、安装命令或效果数据。