dsh-doc-skill

规范文档生成技能（源自 Claude Code /doc 命令）｜ Standardized Document Generation Skill (adapted from the Claude Code /doc command)

A zero-dependency, pure-Markdown DeepSeek Harness (DSH) skill that generates standardized Markdown documents: it automatically creates/reuses a docs/ folder in the current project and writes files named yyyy_MM_dd_HH_<doc-name>.md, with a complete structure tailored to the document type — plus a type-aware "confirm before saving" checklist in the reply.

一个零依赖、纯 Markdown 的 DeepSeek Harness (DSH) 技能：按全局「文档生成规范」生成 Markdown 文档——自动在当前项目下创建/复用 docs/ 文件夹，文件名格式 yyyy_MM_dd_HH_<文档名>.md，正文按文档类型展开完整章节，并在回复中附带类型感知的「落盘前可再确认」检查提示。

English | 中文

English

Features

• Fetches a real timestamp (Get-Date / date, never fabricated) for the filename prefix
• Supports 7+ document types: development implementation plan, project architecture plan, upstream API spec, test plan, deployment guide, requirements spec, change notes, etc.
• Type-aware "confirm before saving" checklist (hints in the reply only — never written into the document body)
• "Consolidate, don't rewrite": stacks on top of existing plans/discussions in the session
• Exception-file protection (README.md, CHANGELOG.md, LICENSE, etc. never go into docs/)
• Hot-reload: drop the file in, no DSH restart needed
• Ships with a full English counterpart: doc-en.md (skill doc-en), same functionality

Install

Option A — user level (available in every project):

# Linux / macOS
mkdir -p ~/.dsh/skills
cp doc.md ~/.dsh/skills/doc.md          # Chinese version (skill: doc)
cp doc-en.md ~/.dsh/skills/doc-en.md    # English version (skill: doc-en)

# Windows PowerShell
New-Item -ItemType Directory -Path "$env:USERPROFILE\.dsh\skills" -Force
Copy-Item doc.md "$env:USERPROFILE\.dsh\skills\doc.md"
Copy-Item doc-en.md "$env:USERPROFILE\.dsh\skills\doc-en.md"

Option B — project level (this project only, ships with the repo):

mkdir -p .dsh/skills
cp doc.md .dsh/skills/doc.md

DSH scans skill roots with hot reload: once the file is in place, the doc skill appears in the session skill catalog (<available_skills>) and the / menu without restarting.

Usage

/doc 订单系统开发实施计划
/doc 用户中心项目架构计划
/doc 支付上游接口说明文档
/doc 回归测试计划
/doc 生产环境部署说明文档

Type /doc <document type or title> in the DSH Web/TUI composer, or simply ask in natural language (e.g. "write me a regression test plan") — the model auto-loads this skill. For the English skill, type /doc-en <document type or title> (e.g. /doc-en Order System Development Implementation Plan).

Output

<project-root>/docs/yyyy_MM_dd_HH_<doc-name>.md, e.g.:

docs/2026_08_17_11_订单系统开发实施计划.md

Compatibility

Adapted from a Claude Code custom slash command (/doc); the frontmatter follows the DSH skill spec (name / description / whenToUse). DSH also scans .agents/skills roots, so with minor tweaks the same content works in other agents that honor SKILL.md conventions (Claude Code / Codex).

License

MIT

中文

功能

• 自动取真实时间戳（Get-Date / date，禁止编造）生成文件名前缀
• 支持 7+ 类文档：开发实施计划、项目架构计划、上游接口说明文档、测试计划、部署说明文档、需求说明文档、变更说明等
• 类型感知的「落盘前可再确认」检查项清单（仅在回复中提示，不写入文档正文）
• 与已有规划/讨论内容「固化而非重写」地叠加落盘
• 例外文件保护（README.md / CHANGELOG.md / LICENSE 等不进 docs/）
• 热加载：文件放入即生效，无需重启 DSH
• 附带英文版技能 doc-en.md（技能名 doc-en），功能一致

安装

方式一：用户级（所有项目生效）

# Linux / macOS
mkdir -p ~/.dsh/skills
cp doc.md ~/.dsh/skills/doc.md          # Chinese version (skill: doc)
cp doc-en.md ~/.dsh/skills/doc-en.md    # English version (skill: doc-en)

# Windows PowerShell
New-Item -ItemType Directory -Path "$env:USERPROFILE\.dsh\skills" -Force
Copy-Item doc.md "$env:USERPROFILE\.dsh\skills\doc.md"
Copy-Item doc-en.md "$env:USERPROFILE\.dsh\skills\doc-en.md"

方式二：项目级（仅当前项目生效，随仓库分发）

mkdir -p .dsh/skills
cp doc.md .dsh/skills/doc.md

DSH 技能目录热加载：文件放入后无需重启，下一次会话即可在技能目录（<available_skills>）与 / 菜单中看到 doc。

用法

/doc 订单系统开发实施计划
/doc 用户中心项目架构计划
/doc 支付上游接口说明文档
/doc 回归测试计划
/doc 生产环境部署说明文档

在 DSH Web / TUI 输入框直接输入 /doc <文档类型或标题>，或直接用自然语言让模型生成（如「帮我写一份回归测试计划」），模型会自动加载本技能。英文版请输入 /doc-en <文档类型或标题>（如 /doc-en Order System Development Implementation Plan）。

生成的文件

<项目根>/docs/yyyy_MM_dd_HH_<文档名>.md，例如：

docs/2026_08_17_11_订单系统开发实施计划.md

兼容性

本技能由 Claude Code 自定义斜杠命令 /doc 适配而来，frontmatter 符合 DSH 技能规范（name / description / whenToUse）。DSH 兼容扫描 .agents/skills 目录，同一份内容稍作调整亦可用于其他支持 SKILL.md 约定的 agent（Claude Code / Codex 等）。

License

MIT