用途:在 skills/ 下新建技能,或对现有技能进行实质性编写刷新。触发示例包括“为……创建技能”“生成 skills/<name>/SKILL.md”“把该工作流转为可复用技能”“改进该技能的元数据与激活线索”“让该技能更易被发现”“为技能配置 references/assets/helper agents”。不适用于编辑 skills/ 之外的产品代码、纯错别字小改,或更适合做成文档、模板、脚本的请求。
主要能力:先判断是否该做成技能(优先复用或改进已有技能),收集必要输入(新建/更新/非技能、目标路径、kebab-case 技能名、一句话用途、激活线索与反触发、预期输出、安全边界),定义至少三个代表性请求作为验收标准,区分能力型与工作流/编码偏好型,并支持独立、编排者、从属三种组合。元数据约束:name 1-64 字符、小写字母/数字/连字符、与文件夹一致、无连续连字符与保留字;description 非空且不超过 1024 字符、第三人称、含 USE FOR/DO NOT USE FOR;无命名约定时默认 custom-<base-skill-name>。
使用方式:编辑前先检查 apm.yml 与 apm.lock.yaml,若目标是外部 APM 安装副本则不应就地修改,应告知来源并改为在源仓库修改或提交问题。随后按需选择最小结构:SKILL.md 必备,references/ 放长指导,assets/ 放模板清单,agents/ 放辅助角色,scripts/ 仅在确定性自动化确有价值时使用。SKILL.md 建议少于 300 行,超 500 行会失败。最后运行目标环境支持的清单/模式校验、策略检查或测试,并按契约报告变更内容、分类、验收请求、使用的辅助角色与校验结果。安全约束:不得索取或暴露密钥,不得未经确认运行破坏性命令,不得编造校验结果,不得添加隐藏网络访问或远程代码执行。具体默认模板见 references/skill-template-baseline.md。