技能解释、拆分与升级
这是一个按需进入的三阶段技能。阶段不是自动串行任务:用户只要求理解时只做“解释”;提出迁移分析时进入“拆分”;要求嵌入自己的工作流时进入“升级”。后一步可引用前一步已经核验的成果;缺少必要前置证据时补最小证据,不要求重写整份报告。每一阶段只读取当前需要的子技能文件。
| 子技能 | 触发 | 读取 | 交付 |
|---|---|---|---|
| 1. 解释 | 看懂、解剖、绘制披露树 | 解释 | 先弹窗选简单或完整;无答复/无法弹窗默认主报告 Markdown+draw.io 图的完整交付 |
| 2. 拆分 | 判断作者规则哪些值得迁移、怎样用 | 拆分 | 带学习动作的四类取舍、还原原规则上下文的映射、限定任务族的候选骨架 |
| 3. 升级 | 改造原技能的某条能力,或把候选规则重组为新工作流 | 升级 | 先选局部改造或工作流重组,给出影响映射与缺口;确认后生成技能并用真实任务验收 |
共同边界:原 Skill 始终是证据对象,读取不授权执行其脚本、安装依赖、修改原包或复制作者私密信息与品牌。分析声明、静态代码、实际运行分开标记。任何阶段都不把缺失信息脑补成用户规则。用户要求只读或禁止写文件时遵守其范围;新技能的生成与运行依“升级”阶段的确认节点执行。阶段间用证据 ID/链接引用已有结论,避免在解释、拆分和升级三份产物中反复抄同一段流程。
分析产物位置:主报告、披露图、规则映射、候选骨架(如适用)、改造映射和验收记录默认放在当前项目文件夹内的清晰分析目录,不放在 ~/.agents/skills、~/.codex/skills 等技能安装目录。用户指定了分析输出位置时照其指定;无法确定哪个文件夹是当前项目或应存放分析结果时,先用用户输入弹窗请用户给出具体目录,得到答复前不猜路径、不写分析文件。派生 SKILL.md 的安装位置另按用户指定或平台约定决定,不与分析产物混放。
若解释阶段既要选择交付程度又缺分析目录,可在同一次弹窗中问清两项;无回复默认完整只决定交付程度,不替代对输出目录的确认。
按需读取 阶段 Harness 与验收:它定义门槛、去重和回归场景;scripts/run_harness.py 可做静态及绘图烟测,不能代替真实桌面演练。