Skip to content

agent-config sync 衛生:description 單一來源化+orphan sweep+trigger 防碰撞 #59

Description

@benwu95

背景(三個同管線的衛生問題)

  1. description 雙來源已漂移skill.ts:123 的 verify 描述停在舊 4 維版本,而 prospec-verify.hbs:3 frontmatter 已是 5+1 維——CLAUDE.md/AGENTS.md registry 正對外散佈過時描述,且無測試釘住兩份等價性
  2. agent sync 無 orphan 清理agent-sync.service.ts:269-311 只寫不掃——skill 更名或移除後,user 專案殘留的舊 SKILL.md 會持續參與 dispatch
  3. trigger 存在 13 組跨 skill substring 碰撞設計設計架構實作如何實作backfill⊂promote-backfill 的 4/5 個 trigger)外加 check/change/完成 等泛用詞;現行 contract 只驗非空

範圍

  1. per-skill render context 傳入單一 skill_descriptionskill.ts.hbs 收斂為單一來源;等價性 contract test
  2. agent-syncprospec-* 目錄 sweep:不在當前 skill 清單者移除(或警示)
  3. 新增 trigger 防碰撞測試(跨 skill substring/完全重複偵測),收緊 baseline 觸發詞後重新生成

驗收條件

  • 雙來源等價 contract test 綠
  • sweep 行為有測試覆蓋(含保留 user 自建非 prospec skill 的 case)
  • 碰撞測試 0 violation

來源

稽核報告 02 兩個 Critical+02-I1(.tasks/chore/scan-by-fable5/,2026-07-03)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions