skill-maintainer
修改已经存在的技能,不负责打分。自检只使用随技能附带的评分档(trust.scan 不评)。任何含 SKILL.md 的目录都可以维护。信号可以来自评分档对照、某一版评测评语、session-retrospective 的复发日志,或中英文与安装树的结构检查。默认一次只提案一条缺口,确认前不写入。说「自动补到阈值」时一轮改一条,文档改不动的子项停下并列出。本仓库的 sync 脚本只在目标位于 skills/ 且脚本存在时可选运行,不发布。触发词:"维护这个技能"、"按 TRACE 过一遍"、"按评测改技能"、"自动补到阈值"、"skill maintainer"。
技能维护
这只技能修改已经存在的技能,不负责打分。本技能用附带的评分档找出一处缺口,写出提案,确认后才改文件。
本技能的版本是 1.0.6。提案里的版本行属于被维护的那只技能,不是本技能。
铁律
- 自检只用附带的评分档。 档位在
references/trace-items.md。trust.scan不评、不打分。技能正文不收录科恩实验室或云鼎实验室的检测规则。本地自测写两行:文档对照档位;是否有真实运行证据。没有第二行,不宣称已经达到阈值。有平台子项分时,听平台分。 - 没有信号不改规则。 信号只来自 TRACE 对照、评测评语、复盘复发、结构检查。对不上 15 个子项、也不是仓库不变量的条目,暂缓。
- 一次一条。 其余缺口写入「本次不改」。
- 默认确认前不写入。 行为有变化时,目标技能的中英文
version一起升一个补丁。只改 README 导航、或只改引用且行为不变时,不升该技能的版本。只有「自动补到阈值」才连续写入,并且仍是一轮一条。 - 已经写入的缺口不再改。 目标文件里已经有这条缺口所要的全部文字时,不提案、不写入。只有一部分时仍算缺口(SM-E17)。再跑一次只报告完整项已在目标里。本技能不访问网络,不设超时。
何时使用
- 「维护这个技能」「按 TRACE 过一遍」「按评测改技能」「自动补到阈值」「skill maintainer」
- 手里有一份评测评语、一条复盘,或一次中英文不一致
- 示例:「维护 example-skill,先给提案。」确认前不改文件。对方回复「确认」后,只改提案里的那一处。
何时不用
- 从零设计一只新技能 →
workflow-skill-designer - 把本次会话记入日志 →
session-retrospective - 要求在本地重做安全扫描 → 停下,说明
trust.scan不在本技能范围内(SM-E05)
流程
- 确定目标技能。 没说清就只问一个问题:改哪一只。任何含
SKILL.md的目录都可以,不要求它在本仓库里。目标目录被挪走或SKILL.md消失时,停下,只问一次新路径(SM-E16)。 - 读取信号。 按入口读取,不要等四类信号齐全。外部材料的最低字段、少见组合的唯一结论在
references/signal-rules.md。- 「按 TRACE 过一遍」:用评分档读
SKILL.md与它点名的引用。某一子项还不能稳定使用,即构成缺口。怎样算稳定使用,以评分档文件的说明为准。 - 评测评语或评测接口结果:把点名的句子对上一个子项。贴来的报告至少要有子项名和分数;缺字段只问一次(SM-E14)。接口读不到时用贴来的报告,并在提案里写明(SM-E08)。
- 复盘日志:默认
metrics/workflow-feedback.jsonl。一行至少要有技能名和缺口;缺字段只问一次(SM-E14)。只采用同一技能、同一缺口的复发项。 - 结构检查:中英文
version、tags数量、英文安装树是否含有 README 点名的脚本。
- 「按 TRACE 过一遍」:用评分档读
- 只留一条。 优先级:安全评语点名的项 → 评测评语 → 复盘复发 → TRACE 对照 → 结构偏差。安全评语只使用对方点名的那一句,不据此补写实验室规则。目标里已经有这条缺口所要全部文字的,跳过并报告已在目标里(SM-E10),再看下一条。只有一部分时仍留作本条(SM-E17)。都已完整在目标里就停下,不写入。
- 写出提案后停下。 模板见
references/proposal-template.md。 - 确认后才写入。 两种语言的文件都在时,对应段落一起改。只有一种语言文件时,只改那一个文件,不另建另一种语言,并写明缺的是哪一个(SM-E11)。写入中途失败:已改的留下,未改的不继续,报告停在哪一段(SM-E15)。中英文只改成一半时走 SM-E04,先补另一种语言和版本,不另开无关缺口。主路径到此结束。只有目标位于本仓库的
skills/<name>/,并且脚本就在旁边时,才可选地运行sync/check.sh --collection-only;若同时存在dsh-plugin/sync.sh,再运行它,不带--publish。脚本不存在,或目标在别的目录,就跳过,并在「本次不改」里写明。脚本失败时按报错修一次再跑;第二次仍失败就停下并报告,不把失败记成通过;修好后另开一次维护(SM-E12)。不发布到 SkillHub,不执行npm publish。
信号优先级、阈值折算、外部材料字段、少见组合与暂缓条件在 references/signal-rules.md。
自动补到阈值
入口是「自动补到阈值」。没有这句时,仍走上面的提案和确认。
- 一轮只改一个靠改文档能提高的子项。两种语言文件都在时一起改;只有一种时按 SM-E11。然后按 signal-rules 的折算再比。
trust.scan不参与。- 阈值、折算、可接受的范围和停机条件写在
references/signal-rules.md。给出的数不在该范围内时,不开始循环,只问一次(SM-E13)。 - 停下时列出仍未达到的子项和原因。不把未运行写成已经验证(SM-E09)。
仓库不变量
缺口也可以落在这些格子上,而不落在某个 TRACE 子项上:
- 中英文同一补丁:改了
SKILL.md的行为,就要改SKILL.en.md的对应行为,版本号同时移动 - 单一事实源:平台副本从
skills/<name>/同步,不手改副本 - 只读技能不写:目标技能若声明只读,维护不给它增加写操作
- 日志不记秘密
异常
| 码 | 场景 | 处理 |
|---|---|---|
| SM-E01 | 没指定目标技能 | 只问一个问题,不开始对照 |
| SM-E02 | 缺口对不上 15 个子项,也不是仓库不变量 | 记为暂缓,不写入 |
| SM-E03 | 一次塞进多条缺口 | 按优先级留下第一条,其余写入「本次不改」 |
| SM-E04 | 两种语言文件都在,却只改了一种 | 停下,先补另一种语言的对应段落和版本号 |
| SM-E05 | 要求在本地做安全扫描 | 说明 trust.scan 不评;不编造扫描分 |
| SM-E06 | 其实是要一只新技能 | 交给 workflow-skill-designer |
| SM-E07 | 其实是要记这次会话 | 交给 session-retrospective |
| SM-E08 | 评测接口不可用 | 改用贴来的报告;提案里写明接口没读。不重试扫描 |
| SM-E09 | 阈值循环停下仍有低分子项 | 列出子项和原因,结束。不把它们改成达标 |
| SM-E10 | 缺口所要的全部文字已经在目标里 | 报告已在目标里。不提案、不写入。还有下一条就改看下一条 |
| SM-E11 | 目标只有一种语言文件 | 只改现有文件,不另建缺的语言。写明缺的是哪一个 |
| SM-E12 | 同步脚本第二次仍失败 | 停下并报告报错。不把失败记成通过。修好后另开一次维护 |
| SM-E13 | 给出的阈值不在 signal-rules 的范围内 | 不开始循环,只问一次。不把越界的数改成默认值 |
| SM-E14 | 复盘行或贴来的报告缺最低字段 | 只问一次。不开始对照 |
| SM-E15 | 确认后写入中途失败 | 已改的留下,未改的不继续。报告停在哪一段 |
| SM-E16 | 目标目录被挪走或 SKILL.md 消失 | 停下,只问一次新路径 |
| SM-E17 | 目标里只有缺口所要文字的一部分 | 仍算缺口。补齐缺的那一段,不跳过 |
目标技能的版本
提案中的版本属于目标技能。行为变化:中英文 frontmatter 的补丁号一起加一。只改 README 导航,或只改引用且行为不变:写「不升版本」。次版本或主版本只在确认时另行指定。
本技能自己的 version 保持当前值,除非这次维护的目标就是 skill-maintainer。
常见问题
问:阈值看各项的平均吗?
答:不看。每个可评子项各自和阈值比。折算算法在 references/signal-rules.md。
问:本地对照档到了 5,算不算达到阈值? 答:有平台子项分时听平台分。没有平台分时,按 signal-rules 的折算记分。本地自测还要写明有没有真实运行证据。
问:自测分能直接当成 SkillHub 分吗? 答:不能。本地只报对照档和是否有真跑证据,不报「已经过平台阈值」。
问:循环会不会一直改下去? 答:不会。达到 signal-rules 里的停机条件就停下,并列出还没达到的子项。
问:没说「自动补到阈值」也会直接改文件吗? 答:不会。那个入口才会连续写入。其他入口先给提案。
问:这只技能负责打分吗? 答:不负责。本技能只修改,不给出分数。
- Downloads
- 42All time
- Security audit
- Pass
- Last updated
- 1d ago
- Current version
- v1.0.6
- License
- MIT-0
