用途:用于创建新技能、修改已有技能,或在部署前验证技能是否有效。目标是构建最小可复用的技能,使其改变决策或改善任务执行,同时不约束无关工作;技能改动采用行为验证,而非代码 TDD 路线,该验证不需要加载 aegis:test-driven-development。
默认路径:
- 确立需求与归属:明确可复用的行为缺口、目标用户/宿主与非目标;检查是否已有技能、项目规则、宿主适配器或自动化检查负责此事,优先最小的既有归属者;对已有技能,先查看其引用、清单或生成副本、发现测试与打包资源;只为可复用且非显而易见的指导创建技能,一次性项目约定留在项目归属者中,机械约束尽量自动化。
- 编辑前记录行为:使用有代表性的任务,而非仅让代理背诵指令的问题;新技能先跑无技能对照,已有技能先跑当前版本,仅在测试技能是否该存在时加无技能消融;覆盖正向触发、负向近似未命中,以及适合该技能类型的压力或应用场景;记录决策、漏调用或多余调用、不安全绕过、证据引用与未知项,不能以行数或字节数作为行为证明;若无法评估有意义的行为,应停在 needs-verification,不得声称已可部署或能力保持。
- 设计最小指令面:假定代理有能力,只保留非显而易见上下文、决策标准、安全边界,以及缺失即造成观察到缺口的步骤;具体程度与风险匹配;描述应简洁、第三人称、有区分度,说明能力与适用时机,仅在防止误路由时加排除项;可执行默认路径与不可省略约束放在 SKILL.md,大量条件细节移到直接引用并说明阅读触发;引用尽量一级深度,默认不全量加载、不在正文重复;只在能稳定决策或输出时加示例,通常一个足够;可移植方法保持宿主中立,宿主工具名、安装路径与界面操作放在宿主自有文档;仓库规范形态为 skills/<skill-name>/SKILL.md,仅带实际使用的引用、脚本或资源。
- 做最小改动:同一切片内处理已观察缺口并移除被取代的重复内容;保留公开署名与外部支持的契约;退役内部归属者、回退或资源时组合 aegis:anti-entropy-governance,不得在无依赖证据下留兼容副本;不得把一个模型的措辞、一次历史事件或假想边界情况变成通用规则。
- 验证候选:在可比较的模型、工具与宿主配置下重跑相同正向、负向与压力/应用场景,比较结果而非措辞;同时验证 frontmatter、name、description 在受支持宿主上可解析,预期请求仍能发现技能而近似未命中不能,每个条件引用可从明确触发抵达,改动脚本运行成功,退役文件与指令无活引用,相关仓库工作流、边界、打包与宿主检查通过;若行为回退,恢复缺失义务或收窄改动,不要新增第二归属者或回退来掩盖。
场景选择:纪律或安全类用真实压力与授权边界;技术类用应用、变体与缺失信息案例;模式类用识别、应用与反例;引用类用检索、正确使用与常见缺口。复杂或高风险技能若需独立评估者增加信心,阅读 testing-skills-with-subagents.md。
完成记录:用自然叙述或等效字段保持紧凑可审计,含行为缺口与规范归属者、基线与候选场景结果、保留与退役的义务/资源、触发与引用检查、验证命令与未覆盖宿主/模型、状态:verified、needs-verification 或 blocked。此为方法包证据,不是权威的完成或部署批准。
限制:资料未提供具体安装命令、价格、支持平台清单或效果数据。