Skip to content

skill template boilerplate partial 化+SKILL.md generated 標記 #60

Description

@benwu95

背景

4 種 boilerplate(Next-Step Handoff、Entry Gate 樣板、Quality Gate 表、Output Contract 樣板)在 17 個 skill template 間 verbatim 手抄 6-17 份(合計 ~190 行;Next-Step Handoff 有 6 份 md5 完全相同)——違反自家 _playbook.md PB-006(單一來源 helper),而 Handlebars partial 機制(template.ts:88-103)早已存在未用。

另外,部署出的 SKILL.md 無任何 generated 標記——使用者手改會在下次 sync 被靜默覆寫。

範圍

  1. 共用段落抽成 Handlebars partials,17 個 template 引用單一來源
  2. SKILL.md 頭部加 generated 標記(註明「由 template 生成,修改請改 src/templates/skills/」)

驗收條件

  • 重新 render 與部署輸出 byte-identical(現況零 drift 必須保持,generated 標記除外)
  • 重複 boilerplate 收斂為 partial 單一來源
  • 既有 vitest 生成契約全綠

排程建議

在 agent-config sync 衛生 issue(#59)合併後進行,避免大範圍 template 衝突。

來源

稽核報告 02-I2(.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