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

instruction-maintenance skillA

instruction-maintenance is agent-read markdown (skill) from minleev5/devkeel: 精简并校验 AGENTS.md、OpenSpec schema/instruction、OPSX commands、SKILL.md、prompt 与 artifact 模板。用于审查当前 diff 的话术冗余、事实源重复、过长规则或镜像漂移, 并在不削弱行为、门禁、权限和恢复语义的前提下改写。.

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

# 指令维护

目标是减少同时进入上下文的重复信息,不追求机械缩短。保留所有会改变动作、停止条件、
权限、失败处理、兼容或恢复结果的规则。

## 1. 建立审查范围

只审查本次任务涉及或当前 diff 修改的指令资产。先运行只读索引脚本:

```bash
node "<skill-dir>/scripts/audit-instruction-diff.mjs" --base HEAD
```

用户明确指定目录时,用可重复的 `--path` 纳入其中所有指令文件,即使文件不在 diff:

```bash
node "<skill-dir>/scripts/audit-instruction-diff.mjs" --base HEAD \
  --path templates/openspec/schemas
```

脚本列出指令文件、长行、解释性话术候选和模板镜像漂移。候选需要人工判断,不自动删除。

## 2. 确认事实源与加载关系

先判断哪些内容会在同一任务中一起加载:

| 资产 | 只保留 |
|------|--------|
| AGENTS.md | 全局优先级、路由、跨流程门禁;不展开命令或 schema 的内部算法 |
| schema.yaml | artifact 图、schema 专属 instruction、执行与关闭门禁 |
| OPSX command | 参数与入口;加载对应 skill 后不重复其算法 |
| SKILL.md description | 能力与触发场景 |
| SKILL.md body | 可复用流程,以及 schema/command 未提供的兼容和失败处理 |
| artifact template | 输出结构、字段约束和格式硬规则,包括 `templates/openspec/schemas/*/templates/` 及镜像 |
| spec / test | 持久行为与验收证据,不作为运行时提示副本 |

只有独立加载的入口才重复必要不变量。若 command 必定加载 skill、skill 必定读取 schema
instruction,就让下游事实源拥有算法,上游只负责选择和传递上下文。

## 3. 判定删改

优先删除或迁移:

- 架构归属、历史原因、实现背景或“本文件负责什么”等旁白;
- 已由目标 skill description 表达的触发条件;
- 同一次加载链中另一事实源的完整算法、字段说明或负向清单;
- 明确命令、状态或 selector 后再次解释其理由;
- 只证明“没有做某事”、但不改变动作或停止条件的话术。

必须保留:

- 会改变路由、执行动作、权限范围或用户确认时机的规则;
- 数据损失、安全、兼容、迁移、回滚和旧状态恢复门禁;
…

Read the whole file at its exact version.

How to install

Latest version
mdr add minleev5/devkeel/instruction-maintenance@v1.0.0
Exact content
mdr add minleev5/devkeel/instruction-maintenance@sha256:1d1621883b1224f3

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_5wwn42nkclr3aalu.svg)](https://markdownregistry.com/a/art_5wwn42nkclr3aalu)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-22 123429c 4,019 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 (4019 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_5wwn42nkclr3aalu
GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/instruction-maintenance
GET https://markdownregistry.com/api/v1/blob/1d1621883b1224f384f81bfa0f726f0e1aff5b95758e03d41dfb3fc64e95238f

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
doc-maintenance skill
minleev5/devkeel · .harness/skills/doc-maintenance/SKILL.md · CLI 文档维护与一致性检查流程
v1.2.0 · 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
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.