Mathodology Skill Authoring 用于在添加、编辑或审查技能、角色提示词及技能元数据时提供写作规范。
用途:围绕决策、证据与有用输出编写可复用指南,说明某种方法何时有帮助、如何识别失败,以及何时更简单的做法更好。避免强制阶段、交接 schema、任意评分以及只是重复其他技能的描述,应改为链接到所属技能。
技能结构:每个技能都有 SKILL.md frontmatter,其中 name 与所在目录一致,description 以 Use when 开头并聚焦触发条件。其 agents/openai.yaml 包含 display_name、short_description 和一个提及对应 $skill-name 的 default_prompt。这些元数据文件是发现接口,不是工作流引擎。角色定义应简洁,并继承宿主选择的模型。
内容组织:把详细的图表配方、来源出处和示例放入所属技能内的 references 或 examples 目录。保持入口点简短,只加载与任务相关的参考。保留第三方许可;切勿把下载的源码快照当作安装步骤执行。
脚本:当脚本执行具体工作(如绘图、备份或渲染)时是合适的。保持其可选,声明依赖,并验证其承诺的行为。不要为强制提示词而创建框架。
维护:更新所有受影响的入口点、角色技能列表、元数据以及英文/中文文档。保持每种语言自然,标题或代码块数量无需一致。检查命令、能力与链接是否一致。用 maintenance 做机械性检查。
限制:资料未提供具体平台支持范围、安装命令或示例代码,以上使用方式与限制基于官方说明整理。