Home / minleev5 / devkeel · .harness/skills/doc-maintenance/SKILL.md · GitHub

doc-maintenance skillA

doc-maintenance is agent-read markdown (skill) from minleev5/devkeel: CLI 文档维护与一致性检查流程.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 文档维护

## 何时使用

- 新增/修改子命令后,同步 help 文本和 docs 项目说明
- 发版时更新 changelog
- 检查文档与代码实现的一致性

## 流程

### 1. Help 文本一致性检查

运行所有命令的 --help,对比 README 命令说明与 docs/development.md:

```bash
node bin/devkeel.js --help
node bin/devkeel.js init --help
node bin/devkeel.js doctor --help
node bin/devkeel.js update --help
node bin/devkeel.js sync --help
node bin/devkeel.js evidence --help
```

检查点:
- README 与 docs 中列出的命令是否与实际一致
- 选项(--fix, --force, --dry-run)是否都有记录
- 不得只用退出码判断命令存在;未知命令可能退回 root help,必须确认输出的 Usage/Options 属于目标子命令

### 2. 项目知识同步

对比 `src/` 实际目录结构与 `docs/architecture.md`,确认:
- 新增的 commands/lib 文件已记录
- 文件职责描述准确
- 测试入口与环境变化同步 `docs/testing.md`,规则复用已有测试策略
- AGENTS/CLAUDE 只维护文档入口与读取条件,不复制正文
- 当前规范保留在 `openspec/specs/`,任务过程保留在 `openspec/changes/`

### 3. Changelog 维护

按 `.harness/skills/changelog/` 规范,先确认 CLI 或 Templates 独立版本流,再只创建对应文件:

- `web/public/versions/cli/X.Y.Z.json`
- `web/public/versions/templates/X.Y.Z.json`

文件名必须匹配 `versions` 最后一项,group type、label、item 顺序和受限 Markdown 均须通过目录校验。不得编辑旧静态 Changelog HTML、手工 latest/Update Tip 或 `web/dist/`。

创建后执行:

```bash
pnpm --dir web exec vitest run tests/version-catalog.test.ts tests/changelog-data.test.ts
pnpm --dir web build
…

Read the whole file at its exact version.

How to install

Latest version
mdr add minleev5/devkeel/doc-maintenance@v1.2.0
Exact content
mdr add minleev5/devkeel/doc-maintenance@sha256:6c9b14262f3fc143

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.2.0 latest2026-09-23 2a3e2e3 2,958 BA view · diff
v1.2.02026-09-23 05b4c72 3,038 BA view · diff
v1.1.12026-09-22 123429c 2,790 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (2958 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

minleev5/devkeel · 3 stars · license MIT · pushed 2026-09-24 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_nwawhpvgb6xey52k
GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/doc-maintenance
GET https://markdownregistry.com/api/v1/blob/6c9b14262f3fc143a20b1e6e1a50fe1a130ee1841c26b8cee5ecf52f34649b02

Your agent 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.

More from minleev5/devkeel

brainstorming skill
minleev5/devkeel · .harness/skills/brainstorming/SKILL.md · 探索、比较、挑战或补全开发方案;按 Lite/Full 深度进行单题访谈,并在用户同意持久化后维护 OpenSpec Living brainstorm。
v9.1.1 · audit A · 3 stars
changelog skill
minleev5/devkeel · .harness/skills/changelog/SKILL.md · Use when 编辑 changelog、发布 CLI 或模板版本、或判断某项用户可见变更是否需要进入版本记录。
v3.0.0 · audit A · 3 stars
commit skill
minleev5/devkeel · .harness/skills/commit/SKILL.md · 用户明确选择 commit、push 或 MR/PR 后使用的原子交付流程。任务完成或归档本身不触发;在授权范围内完成交付目标及其必要动作。
v1.2.4 · audit A · 3 stars
domain-init skill
minleev5/devkeel · .harness/skills/domain-init/SKILL.md · 对项目进行全盘扫描,识别领域类型和技术栈,通过多 subAgent 并行扫描多维度, 生成项目知识 docs 与专属 rules、skills 和 agents。使用「自动 baseline + 交互式增强」…
v2.0.2 · audit A · 3 stars
health-check skill
minleev5/devkeel · .harness/skills/health-check/SKILL.md · 一键检查项目代码健康度指标
v1.0.0 · audit A · 3 stars
instruction-maintenance skill
minleev5/devkeel · .harness/skills/instruction-maintenance/SKILL.md · 精简并校验 AGENTS.md、OpenSpec schema/instruction、OPSX commands、SKILL.md、prompt 与 artifact 模板。用于审查当前 diff…
v1.0.0 · audit A · 3 stars
jira-defect-orchestrator skill
minleev5/devkeel · .harness/skills/jira-defect-orchestrator/SKILL.md · 独立编排 Jira 缺陷的取证、修复、验证、回填与 MR 交付,按决策风险确认。适用于用户提供 Jira URL 或 issue key,要求结合运行日志、配置、只读业务数据和代码证据处理生产或测试环境缺陷;普通无 Jira…
v1.3.2 · audit A · 3 stars
new-subcommand skill
minleev5/devkeel · .harness/skills/new-subcommand/SKILL.md · 为 DevKeel CLI 新增子命令的标准开发流程
v1.0.0 · audit A · 3 stars
openspec-apply-change skill
minleev5/devkeel · .harness/skills/openspec-apply-change/SKILL.md · 按 OpenSpec 动态 apply instruction 实施 change tasks,并处理 DevKeel 收尾门禁。
v3.2 · audit A · 3 stars
openspec-archive-change skill
minleev5/devkeel · .harness/skills/openspec-archive-change/SKILL.md · 检查完成状态、评估 spec sync,并按 schema 收尾门禁归档 OpenSpec change。
v3.3 · audit A · 3 stars
openspec-bulk-archive-change skill
minleev5/devkeel · .harness/skills/openspec-bulk-archive-change/SKILL.md · 批量检查 spec 冲突,并按 schema 门禁归档用户明确选择的多个 OpenSpec changes。
v2.2 · audit A · 3 stars
openspec-continue-change skill
minleev5/devkeel · .harness/skills/openspec-continue-change/SKILL.md · 继续 OpenSpec change;Draft 时继续单题访谈,Confirmed 后每次最多投影一个 planning artifact。
v2.2 · audit A · 3 stars

Every file in minleev5/devkeel

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