前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在構建智能體工作流時，如何標準化決策記錄、確保內容格式一致以及維護技能體系，往往需要重複配置。Agent Notes Toolkit 針對這些痛點，提供了一個便攜式的解決方案，將驗證機制、腳手架 CLI 和 DSH 預設集成在一起。
這是什麼¶
這是一個實現 Agent Notes 機制的便攜式工具包。它包含驗證門控、腳手架 CLI、維護技能以及 DSH 專用的 AN 預設/捆綁包。
- 維護者: liangminhua
- 分類: 工作流
- 許可證: MIT
核心功能¶
該插件提供以下核心能力：
- 驗證門控: 包括 tree（生命週期/分類樹）、classification（遺留路徑）、format（頭部區塊+骨架+備選方案）、archive（凍結歸檔封印）、links（相對鏈接和錨點）以及 wrap（每段一個物理行）。
- 腳手架 CLI: 提供 init（初始化）、migrate（遷移）命令。
- CI 工作流生成: ci-setup 命令用於檢測 CI 提供商並生成獨立的工作流文件。
- 技能管理: skills add 命令用於複製技能。
- DSH 捆綁集成: preset-install 命令用於寫入 AN 預設。
- Agent Notes 機制: 基於決策記錄的底層實現。
安裝與啓用¶
在 DSH 環境中，使用官方命令安裝此插件：
dsh plugin --profile web add github:liangminhua/agent-notes-toolkit
安裝後，AN 預設會出現在預設選擇器中。
典型用法¶
該工具包提供了以下典型操作命令：
# 初始化項目骨架和種子筆記
npx an init
# 運行所有驗證門控
npx an verify
# 生成 CI 工作流文件
npx an ci-setup
# 遷移骨架文件以匹配工具包版本
npx an migrate
# 添加技能到 .agents/skills
npx skills add <owner/repo or git repo>
# 安裝 AN 預設
npx an preset-install
注意：
* npx 命令從緩存運行，除非使用 npm install，否則不會安裝到項目中。
* an verify 在失敗時會以每行一個違規項退出代碼 1。
* an ci-setup 永不會覆蓋現有文件。
* an preset-install 會寫入到 $DSH_HOME/.agent-presets/an。
適用場景與注意¶
- 適用場景: 需要標準化決策記錄結構、統一 Agent 技能管理以及自動化 CI 驗證的開發者。
- 權限注意: 插件以當前 DSH 進程權限運行，請確保安裝前檢查源碼與許可證。
- 生態背景: 該插件來自社區目錄，與 DeepSeek 或幻方無官方從屬關係。
總結¶
Agent Notes Toolkit 通過統一的引擎和門控機制，簡化了 Agent Notes 的維護流程。如果你需要在 DSH 中引入結構化的決策記錄驗證和技能管理，可以參考其 GitHub 倉庫或社區目錄獲取更多細節。
