前言¶
DSH 的 AGENTS.md 文件受 65536 字節預算限制。當預算不足時,最寬泛的文件優先被丟棄,這會導致工作流規則靜默失效。原來的做法是將工作流直接寫入 AGENTS.md,存在失效風險。dsh-godot-workflow 通過宿主的 ctx.systemPrompt.section() 將 Godot 工程開發工作流常駐注入,不再佔用 AGENTS.md 的字節預算。
這是什麼¶
這是一個由 AtlacherCoder 維護的本地 DSH 插件。它將原本放在 AGENTS.md 中的 Godot 工作流拆分爲兩部分:常駐精簡核心和按需加載的完整技能,確保工作流在預算緊張時依然可用。
核心功能¶
- 將
AGENTS.md中的 Godot 工作流轉爲本地插件。 - 常駐注入精簡核心,不佔用
AGENTS.md字節預算。 - 按需加載
godot-workflow技能。 - 包含五條鐵律、流程骨架及崩潰級硬約束。
- 包含完整流程細則、硬約束全表及四類模板。
安裝與啓用¶
使用 link: 協議安裝,源碼修改即時生效,但插件內容在激活時讀取,修改 .md 後需重啓 dsh web 才能重新注入。
dsh plugin --profile web add link:/home/atlaslinux/PluginManager/dsh-godot-workflow
dsh --profile web --dump-config | grep -A2 godot-workflow
排序與用法¶
常駐核心的排序錨點爲 510,位於 PLAN_POLICY(500) 之後、TEAM_POLICY(600) 之前;取不到錨點時回落 550。
兩個通道分別用於不同場景:
- 常駐段落
godot:workflow:對應.dsh/prompt/core.md(約 3 KB),包含五條鐵律、流程骨架及崩潰級硬約束。每個會話自動加載。 - 技能
godot-workflow:對應.dsh/skills/godot-workflow/SKILL.md(約 9.7 KB),包含完整流程細則、硬約束全表及四類模板。Agent 通過skill工具按需加載。
已知限制¶
- 異常處理:DSH 啓動全有全無,插件異常不拋錯,只記
error日誌並降級。 - 功能邊界:不處理決策日誌同步、回退件及門禁,由各工程
tools/腳本承擔。 - 文件更新:使用
link:協議修改源碼後,必須重啓dsh web才能重新注入.md文件。 - 體積:常駐核心實際體量爲 3038 B,大於設計目標 ~2 KB。
自檢¶
插件包含自檢腳本,可在安裝或開發階段把關完整性:
node scripts/verify.mjs
node scripts/verify.mjs --against ~/.dsh/AGENTS.md
結尾¶
該插件通過分離常駐核心與完整技能,確保了 Godot 工作流在 AGENTS.md 預算不足時依然可用。更多詳情可參考項目主頁。