open-skills-authoring-kit

# SKILL.md ## 触发条件（Trigger） 当用户提出以下任一请求时触发： - "help me write a skill" - "create a runbook for this task" - "draft a SKILL.md" - "I want to teach my agent to do X" - "make this repeatable" - 或任何明确要求将可重复的代理行为编码为可重用文件的请求 ## 工具（Tools） - 文件系统访问权限（用于创建和写入 `.skill/` 目录下的 `SKILL.md` 文件） - Markdown 格式化能力 - 结构化模板生成能力 ## 边界（Boundaries） - 仅响应用户明确请求创建技能文件的情况，不主动生成未请求的技能文档。 - 生成的 `SKILL.md` 必须严格遵循五部分结构：trigger、tools、boundaries、verification、phases。 - 不得包含与当前任务无关的额外内容或假设性功能。 - 若用户未提供具体任务细节（如“X”），则使用通用占位符并提示用户补充。 ## 验证（Verification） - 检查生成的 `SKILL.md` 是否包含全部五个部分且结构完整。 - 确认文件已成功写入 `.skill/` 目录（如不存在则自动创建）。 - 向用户返回文件路径及简要摘要，例如：“已创建 .skill/SKILL.md，包含 trigger、tools、boundaries、verification 和 phases 五部分。” ## 阶段（Phases） ### 阶段 1：解析用户意图 - 识别用户请求是否匹配任一触发条件。 - 提取任务关键词（如“write a skill”、“teach my agent to do X”中的“X”）。 ### 阶段 2：构建技能框架 - 初始化五部分结构的 Markdown 模板。 - 填充 trigger 部分：列出所有有效触发短语。 - 填充 tools 部分：声明所需工具（文件系统、Markdown 等）。 - 填充 boundaries 部分：定义行为限制和范围。 ### 阶段 3：定制内容 - 若用户提供具体任务描述（如“I want to teach my agent to generate reports”），将其融入 verification 和 phases 中。 - 若未提供具体细节，在 phases 中使用通用占位符（如“执行用户指定的可重复任务 X”），并在 verification 中注明需用户后续补充。 ### 阶段 4：生成并保存文件 - 将完整的 `SKILL.md` 内容写入 `.skill/SKILL.md`。 - 确保目录存在，必要时自动创建 `.skill/` 文件夹。 ### 阶段 5：反馈与确认 - 向用户输出成功消息，包含文件位置和关键信息。 - 提示用户可根据需要进一步编辑该技能文件以适配具体场景。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本