前言¶
DeepSeek Harness（DSH）強調“一切皆插件”。在構建編碼 Agent 時，行爲的一致性與可追溯性往往依賴於人工維護的規範文檔。agent-discipline 是一個 DeepSeek Harness bundle，它將《Harness Engineering Methodology》（HARNESS-METHODOLOGY-SPEC v1.0）轉化爲可執行的工程約束。該插件通過注入方法論提示段、提供腳手架工具以及執行合規審計，旨在爲 AI Agent 的倉庫開發建立一套自動化的紀律約束體系。
核心功能¶
提示段注入
插件安裝後會自動向 Harness 的 system-prompt 注入 agent-discipline 章節（order -90）。模型將依據該章節中的 §1.3 會話生命週期與核心不變式開展工作，確保 Agent 遵循預定義的開發範式。
工具集
插件提供三個核心工具，用於狀態管理、初始化和審計：
- agent_discipline_init：在目標倉庫生成 §8 工件模板（包含入口指令、特性清單、進度追蹤、驗證門、命名註冊等）。
- agent_discipline_audit：對照 §10 審計規範，對倉庫進行只讀的啓發式檢查（涵蓋 CRITICAL 6 項及推薦抽樣、五子系統評分等）。
- get_feature / update_feature / verify_feature：用於狀態機的服務化操作，替代手動修改 JSON 文件。
狀態機服務化（形態 C）
當前版本（形態 C）已落地。狀態機被服務化爲 Harness 的能力縫，通過 ctx.features 進行管理。
- 嚴格狀態摺疊：實現了形態 C 的嚴格摺疊機制，非法狀態跳轉或缺失證據（如 WIP=1 無證據）會被判定爲 corrupt。
- 事件日誌真源：會話日誌是狀態真源，feature_list.json 僅爲導出投影。手動修改投影文件會被真源覆蓋。
- 自證：插件自身採用 Dogfooding 方式開發，可通過 node scripts/acceptance.mjs self 進行自審計。
安裝與啓用¶
在 DeepSeek Harness 環境中，通過官方 CLI 安裝該插件：
dsh plugin --profile web add agent-discipline
安裝後無需額外配置，提示段注入與工具註冊自動生效。
典型用法¶
初始化倉庫工件
在目標倉庫目錄下執行初始化工具，生成所需的 §8 工件模板。若文件已存在，工具會自動跳過。
agent_discipline_init
執行合規審計
使用審計工具對照 §10 規範檢查當前倉庫狀態。該工具爲只讀操作，主要進行文本和結構啓發式檢查，不會執行目標倉庫的具體驗證命令。
agent_discipline_audit
自證插件狀態
爲了確保插件本身符合其定義的紀律，可運行自證腳本：
node scripts/acceptance.mjs self
適用場景與注意¶
適用場景
適用於需要嚴格遵循工程方法論進行代碼生成的 Agent 場景，特別是對倉庫狀態機、特性清單管理和審計合規有較高要求的團隊。
注意事項
- 審計範圍：agent_discipline_audit 爲啓發式檢查，不執行目標倉庫的驗證命令本身，僅作文本和結構分析。
- 狀態真源：feature_list.json 是導出投影，禁止手動編輯，應通過 get_feature / update_feature 等工具進行修改，否則會被真源覆蓋。
- 依賴版本：依賴版本聲明爲 >=0.1.0-0，這是預發佈期的寬鬆聲明，正式環境可能需要收緊。
- 可選伴生：invariant 伴生模塊爲可選裝配，需單獨引入 @deepseek-ai/dsh-invariants 才能啓用內部攔截。
結語¶
agent-discipline 通過將方法論從文檔轉化爲代碼約束，爲 DSH 插件開發提供了紀律保障。它結合了形態 C 的嚴格狀態摺疊與事件溯源機制，使得 AI Agent 的開發過程具備更強的可控性與可審計性。
