前言¶
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 仓库或社区目录获取更多细节。
