Introduction¶
The core philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” When building agent workflows, standardizing decision records, ensuring consistent content formatting, and maintaining a skills system often require repetitive configuration. Agent Notes Toolkit addresses these pain points with a portable solution that integrates validation gates, scaffolding CLI utilities, and DSH presets.
What Is This¶
This is a portable toolkit implementing the Agent Notes mechanism. It includes validation gates, scaffolding CLI utilities, maintenance skills, and AN presets/bundles for DSH.
- Maintainer: liangminhua
- Category: Workflows
- License: MIT
Core Features¶
This plugin provides the following core capabilities:
- Validation Gates: Includes tree (lifecycle/classification tree), classification (legacy paths), format (header block + skeleton + alternatives), archive (frozen archive seal), links (relative links and anchors), and wrap (one physical line per paragraph).
- Scaffolding CLI: Provides init (initialization) and migrate (migration) commands.
- CI Workflow Generation: The ci-setup command detects CI providers and generates standalone workflow files.
- Skill Management: The skills add command copies skills.
- DSH Bundle Integration: The preset-install command writes AN presets.
- Agent Notes Mechanism: Underlying implementation based on decision records.
Installation and Activation¶
In a DSH environment, install this plugin using the official command:
dsh plugin --profile web add github:liangminhua/agent-notes-toolkit
After installation, the AN preset will appear in the preset selector.
Typical Usage¶
The toolkit provides the following common operational commands:
# 初始化项目骨架和种子笔记
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
Note:
* npx commands run from the cache and are not installed into the project unless npm install is used.
* an verify exits with code 1 when it fails, listing one violation per line.
* an ci-setup never overwrites existing files.
* an preset-install writes to $DSH_HOME/.agent-presets/an.
Applicable Scenarios and Cautions¶
- Applicable Scenarios: Developers who need standardized decision-record structures, unified Agent skill management, and automated CI validation.
- Permissions Note: The plugin runs with the permissions of the current DSH process. Please ensure that you review the source code and license before installing.
- Ecosystem Context: This plugin comes from the community directory and has no official affiliation with DeepSeek or High-Flyer.
Summary¶
Agent Notes Toolkit simplifies Agent Notes maintenance through a unified engine and gating mechanism. If you need to introduce structured decision-record validation and skill management in DSH, you can refer to its GitHub repository or community directory for more details.