交付文件裏的 [X] 或 {{name}} 很容易暴露這是 AI 生成的。除了顯式的佔位符,模板中常見的樣例行、頁腳的 “Acme Corp” 或示例數據也是殘留。template-instantiator 提供了一套機械化的流程,在交付前確認模板已被正確填充,沒有留下未處理的佔位符或示例內容。
是什麼¶
這是 ChenneyZhuang 維護的一個 DSH 工作流插件。它的核心價值是在交付文件前,通過機械化的盤點、替換和掃描,生成一份零命中報告,證明模板已無殘留,而非僅僅“看起來”已填充。
核心功能¶
- 盤點所有佔位符和變體:識別模板中的
{{var}}、[X]、TODO/FIXME/TBD、Lorem ipsum 以及示例行。 - 從提供的數據替換:使用提供的數據或約定來源進行填充。不編造不存在的值,刪除用戶未請求的可選部分,不留半成品。
- 機械掃描與零命中證明:對所有盤點出的模式進行全量掃描,並輸出結果,證明無殘留。
安裝與啓用¶
執行以下命令安裝插件:
npx skills add ChenneyZhuang/template-instantiator
各 agent 的具體安裝路徑請參考 COMPATIBILITY.md。
使用流程¶
該插件的工作流程固定爲“盤點、替換、掃描、出示零”:
- 盤點:列出模板中所有佔位符和變體。
- 替換:從提供的數據或約定的來源進行填充。
- 掃描:對最終文件進行機械掃描,確保所有盤點的模式都被處理。
- 出示:在交付說明中展示掃描結果(檢查的模式、命中的項、已解決的項)。
注意事項與侷限¶
- 掃描範圍限制:掃描只能找到盤點過的模式。如果模板中包含未被列出的佔位符樣式,這些殘留物不會被檢測到。
- 內容正確性:插件只能證明“無殘留”,不能證明“內容正確”。填充法律或合規模板時,仍需進行領域審查。
- 許可證:MIT。
總結¶
template-instantiator 通過機械化的流程確保交付物的純淨度,適合需要嚴格控制模板交付質量的場景。查看插件詳情:catalog_url 或源碼:github_url。