dsh-doc SKILL.md skillA

dsh-doc from qufei1993/skills-hub is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add qufei1993/skills-hub/dsh-doc@git:20261030.1b17503

Pins git:20261030.1b17503 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
qufei1993/skills-hub
Path
skills/dsh-doc/SKILL.md
Versions recorded
1
Latest version
git:20261030.1b17503, committed Oct 30, 2026
Size
3,153 bytes
Repository stars
1,863
License
MIT

创建或维护工程文档、设计决策、事故复盘、归档提案或产品迁移指南时使用,保留事实依据、实际备选方案和准确状态。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 维护有用的工程文档

阅读[项目上下文](references/project-context.md)和[文档写作](references/prose.md)。创建文档前,先找到现有负责维护相关事实的位置。

1. 明确读者、任务和实际源码行为。涉及默认值、输入输出、失败恢复及兼容性时,阅读实现和真实示例。
2. 选择下面与任务有关的流程,只组合请求需要的部分。
3. 优先修改事实的现有维护文档,更新导航和指向它的链接,并在任务范围内清理矛盾的重复说明。沿用项目的文档约定和语言。
4. 验证示例、路径和链接,对照代码检查语义。格式检查不能证明事实正确或内容完整。适用时执行项目必需检查。

## 当前行为文档

说明前置条件、受支持用法、代表性示例、重要限制和失败行为。注释解释行为约定或不明显的选择,不记录修改过程。公开行为变化时,在同一次改动中更新读者实际使用的入口文档。

## 决策和事故记录

沿用项目已有记录结构。长期选择的理由若会丢失,应记录下来;普通局部修改不需要决策记录。重大漏检缺陷、重复故障或用户明确要求时编写事故记录,不要求每次修复都做复盘。

- 决策使用[决策模板](templates/decision-record.md):问题、选定行为、真实备选方案及落选理由、影响、证据和状态。同时记录收益与代价。移除功能时保留原始需求、失去的能力和重新考虑的条件。历史缺失时不编造备选方案,新增建议与历史决定分开标注。
- 事故使用[复盘模板](templates/postmortem.md):实际影响、已知经过、原因、现有检查为何漏检、修正和防复发措施。每项防护对应到它能检出的故障、已知的实际负责人,以及代码或测试证据;区分拟议、已实现和已验证。缺失的日期、负责人、链接或测试结果保持未知,不补造。

区分假设与已经核实的事实。当前指南不保留会话推理过程,但保留解释长期约束的理由。

## 已实施提案与归档

将提案标为已交付前,验证实际实现。核对名称、路径和机制与现状一致,同时保留历史决策。只有状态适合归档时才归档,修复指向它的链接,并注明当前维护位置或后继文档。不得悄悄删除仍有效的需求,或将历史改写为当前行为。

## 产品迁移指南

说明受影响版本和用户、新旧行为、前置条件、可执行步骤、兼容期、验证方式及回退限制。涉及持久化数据时,明确格式负责方、备份策略和迁移中断后的行为。用代表性的旧数据走真实迁移入口。不要将产品迁移与 DSH Engineering Skill 安装包更新混淆。

报告改动的维护文档、已验证行为和未解决的事实问题。翻译与发布仍是需要明确提出的独立任务。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add qufei1993/skills-hub/dsh-doc@sha256:96e8102c37f4c356

The line at the top of this page pins the label git:20261030.1b17503, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xtdhduiv534kv4az.svg)](https://markdownregistry.com/a/art_xtdhduiv534kv4az)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 30, 2026.

versioncommittedcommitsizeaudit
git:20261030.1b17503 latest2026-10-30 1b17503 3,153 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3153 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

qufei1993/skills-hub · 1,863 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xtdhduiv534kv4az
GET https://markdownregistry.com/api/v1/resolve?ref=qufei1993/skills-hub/dsh-doc
GET https://markdownregistry.com/api/v1/blob/96e8102c37f4c356717487ef77ac8570b7ab4cf706661748b8b092dee34f5bc3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from qufei1993/skills-hub

AGENTS.md AGENTS.md file
qufei1993/skills-hub · AGENTS.md
git:20261031.fd923cf · audit A · 1,863 stars
CLAUDE.md CLAUDE.md file
qufei1993/skills-hub · CLAUDE.md
git:20260411.fabf493 · audit B · 1,863 stars
dsh-ci-test-reliability SKILL.md skill
qufei1993/skills-hub · skills/dsh-ci-test-reliability/SKILL.md · 设计或审查测试覆盖、选择单元/集成/真实入口/端到端测试及 mock 边界时使用;也用于诊断偶发失败、异步、并行及持有资源的测试。适用于测试计划、回归覆盖缺口和不可靠的 CI 证据。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-client-ui-ux SKILL.md skill
qufei1993/skills-hub · skills/dsh-client-ui-ux/SKILL.md · 设计、实现或审查客户端 UI、响应式布局、交互状态、焦点或失败反馈时使用,结合真实运行界面验证用户体验。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-code-review SKILL.md skill
qufei1993/skills-hub · skills/dsh-code-review/SKILL.md · 审查代码改动或 PR 时使用,依据目标项目的实际需求检查正确性、生命周期、接口行为、验证证据和文档,报告有依据且可采取行动的问题。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-engineering SKILL.md skill
qufei1993/skills-hub · skills/dsh-engineering/SKILL.md · 用于功能开发、问题修复和实现设计,按项目现有约定处理默认值、输入校验、依赖和测试选择;也用于诊断、接入、更新或撤销项目 AI 工程规范,保留原有政策和本地修改。用户提出“按 DSH 规范开发”或“接入 AI 工程规范”时使用。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-error-handling SKILL.md skill
qufei1993/skills-hub · skills/dsh-error-handling/SKILL.md · 实现或审查错误传播、部分成功、结果未知、恢复、重试、取消或失败反馈时使用,明确状态保证和错误处理责任。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-find-simplifications SKILL.md skill
qufei1993/skills-hub · skills/dsh-find-simplifications/SKILL.md · 用户明确要求审查或实施简化时使用,识别不必要的抽象、重复状态和兼容机制,并验证受支持行为得到保留。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-pre-push-checks SKILL.md skill
qufei1993/skills-hub · skills/dsh-pre-push-checks/SKILL.md · 在交付或推送前验证改动时使用,核实项目必需检查、当前构建产物和真实用户行为,区分通过、失败、未运行与环境阻塞。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-record-browser-gif SKILL.md skill
qufei1993/skills-hub · skills/dsh-record-browser-gif/SKILL.md · 用户要求从真实浏览器应用录制 GIF 演示时使用,完成实际操作、采集、本地编码和结果核验。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-speed-up-perf SKILL.md skill
qufei1993/skills-hub · skills/dsh-speed-up-perf/SKILL.md · 调查性能问题或优化实际测量的用户路径时使用,建立优化前后对照,保留正确性、失败行为和真实运行证据。
git:20261030.1b17503 · audit A · 1,863 stars
dsh-translate-docs SKILL.md skill
qufei1993/skills-hub · skills/dsh-translate-docs/SKILL.md · 仅在用户明确调用时翻译或同步指定文档,保留技术含义、结构、命令和两边的独立修改。
git:20261030.1b17503 · audit A · 1,863 stars

Every file in qufei1993/skills-hub

Browse by kind, by grade A, or by owner.