write-maintenance-log SKILL.md skillA

write-maintenance-log from kihara777/nixkits is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kihara777/nixkits/write-maintenance-log@git:20261017.ba7a5c1

Pins git:20261017.ba7a5c1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kihara777/nixkits
Path
skills/write-maintenance-log/SKILL.md
Versions recorded
15
Latest version
git:20261017.ba7a5c1, committed Oct 17, 2026
First version recorded
Jun 23, 2026
Size
23,618 bytes
Repository stars
28
License
MIT

按统一规范撰写或更新 MAINTENANCE.md 维护日志。支持软件更新、错误修复、技能文档、CI/CD 与跨仓库子项目链式更新五类记录,自动关联 git commit、生成摘要、多语同步。.

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

# 维护日志撰写

按统一规范撰写 `MAINTENANCE.md` 维护记录,确保格式一致、信息完整、多语同步。
(该规范源自 NixKits,但本技能适用于任何采用同结构的仓库。)

## 自动发现契约

本技能通过纯自然语言约定发现语言扩展:

1. **扫描** — 在 `skills/translate-*/` 目录下查找所有翻译技能
   (**已安装到助手目录时**同级路径为 `<助手目录>/skills/translate-*/`,
   如 `~/.opencode/skills/`;两处都扫,扫不到则退回读取仓库现有的语言清单
   ——**不要当成"没有扩展语言"**)
2. **读取** — 解析各 SKILL.md frontmatter 中的 `language_code` / `display_name` / `base_language` 字段
3. **注册** — 自动将发现的语言扩展纳入多语同步流程。各翻译技能的 SKILL.md 正文中定义翻译规则(词典、语序调整、假名剥离)和列名映射表(TITLE / SUBTITLE / SUMMARY 等多语对照)。

## 入口

**触发约定**:若当前仓库的代理规则文件(如 `AGENTS.md` / `CLAUDE.md`)规定
「每次 `git push` 后补录维护日志」,则按其规则在每次 push 后执行入口 1 的
SHA 查重流程;**仓库没有该规则时**,由用户显式触发(入口 1 / 入口 2 的触发词)。

本技能提供两个独立入口,根据用户意图自动匹配。

### 入口 1:记入维护记录

**触发词**:「记入维护记录」「记录本次修复」「写入维护日志」

基于当前对话中完成的软件更新或错误修复,撰写单条维护记录并插入 `MAINTENANCE.md`。

> 此入口可由**仓库适配层的更新检查流程**在软件更新完成后自动调用
> (NixKits 用 `nixkits-check-updates` 作为该适配层)。

### 入口 2:更新维护记录

**触发词**:「更新维护记录」「补全维护记录」「同步维护日志」

基于 `git log` 扫描全部提交历史,找出以下未记录的内容并补全:

- 未被记录的 `fix(...)` / `feat(...)` 提交
- 缺失关联 commit id 的旧记录(回填 `| 提交 | 说明 |` 表)
- 格式不统一、行文不规范的历史条目(统一为新格式)

**执行流程**:

```bash
# 1. 提取所有 fix / feat 提交(排除 docs 和 chore(pkgs) 类型)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kihara777/nixkits/write-maintenance-log@sha256:1cfe1ef4ee70a53e

The line at the top of this page pins the label git:20261017.ba7a5c1, 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_igu3eyiikisjvf4v.svg)](https://markdownregistry.com/a/art_igu3eyiikisjvf4v)

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

Versions

The registry has recorded 15 versions of this file, between Jun 23, 2026 and Oct 17, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20261017.ba7a5c1 latest2026-10-17 ba7a5c1 23,618 BA view · diff
git:20261005.64636402026-10-05 6463640 23,030 BA view · diff
git:20261005.8d58fb32026-10-05 8d58fb3 22,124 BA view · diff
git:20261005.e2cb5ab2026-10-05 e2cb5ab 21,790 BA view · diff
git:20261002.bad01c42026-10-02 bad01c4 19,356 BA view · diff
git:20261002.1c6e4be2026-10-02 1c6e4be 18,725 BA view · diff
git:20261002.7d3fae02026-10-02 7d3fae0 17,769 BA view · diff
git:20260920.dac80a72026-09-20 dac80a7 16,083 BA view · diff
git:20260917.b7e97172026-09-17 b7e9717 15,255 BA view · diff
git:20260916.667bf6e2026-09-16 667bf6e 12,099 BA view · diff
git:20260817.cc768d02026-08-17 cc768d0 11,993 BA view · diff
git:20260715.6433bac2026-07-15 6433bac 12,252 BA view · diff
git:20260715.6f2e1282026-07-15 6f2e128 12,559 BA view · diff
git:20260625.66f29f02026-06-25 66f29f0 11,832 BA view · diff
git:20260623.2e719df2026-06-23 2e719df 10,917 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 (23618 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

kihara777/nixkits · 28 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_igu3eyiikisjvf4v
GET https://markdownregistry.com/api/v1/resolve?ref=kihara777/nixkits/write-maintenance-log
GET https://markdownregistry.com/api/v1/blob/1cfe1ef4ee70a53e4a91ee0fd4196a1a46f26c47a325b94d73a4aa33c581aea4

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 kihara777/nixkits

AGENTS.md AGENTS.md file
kihara777/nixkits · AGENTS.md
git:20261026.93adc54 · audit A · 28 stars
news-three-elements SKILL.md skill
kihara777/nixkits · packages/dsh-preset-news-three-elements/bundled/news-three-elements/SKILL.md · 以真实通讯社新闻格式编造「催逝快讯」——本技能里的「新闻三要素」不指新闻学那三样,而是三位必须到场的主角:巴兰尼科夫、尤丁采夫、布亚诺夫。触发词「新闻三要素」;含素材搜索、格式硬性要求、用语模板、宽松的拒绝服务判定(先当素材,接不回来才拒)…
git:20260915.a0759b1 · audit A · 28 stars
agent-self-maintenance SKILL.md skill
kihara777/nixkits · skills/agent-self-maintenance/SKILL.md · 用五个「会失败」的小机制让 AI 编码助手长期维护自己的记忆——日记闸门、开局对账、事实核查、自我观察、自检收据。适用于任何有 journal/ 与自检脚本的仓库;含各机制的判据与边界(目录缺失时说什么、数据为什么不能随机制搬走)。
git:20261104.8c7c4cc · audit A · 28 stars
news-three-elements SKILL.md skill
kihara777/nixkits · skills/news-three-elements/SKILL.md · 以真实通讯社新闻格式编造「催逝快讯」——本技能里的「新闻三要素」不指新闻学那三样,而是三位必须到场的主角:巴兰尼科夫、尤丁采夫、布亚诺夫。触发词「新闻三要素」;含素材搜索、格式硬性要求、用语模板、宽松的拒绝服务判定(先当素材,接不回来才拒)…
git:20260915.a0759b1 · audit A · 28 stars
nix-flake-update-check SKILL.md skill
kihara777/nixkits · skills/nix-flake-update-check/SKILL.md · 检查任意 nix flake 仓库中软件包的上游版本更新并升级——开工前先同步远端并核对活跃 issue / PR、按包型(npm / cmake / Rust / fetchurl / python)分流的 hash 更新流程与自托管…
git:20261022.edd2bef · audit A · 28 stars
nix-packaging SKILL.md skill
kihara777/nixkits · skills/nix-packaging/SKILL.md · 从零把一个上游软件打包成 Nix 表达式——按来源类型分流(GitHub 源码 / npm / Rust / 预编译二进制 / Gitea)、hash 的两段式获取(fakeHash → 读取 got → 回填 →…
git:20261024.8b180c4 · audit A · 28 stars
nixkits-check-updates SKILL.md skill
kihara777/nixkits · skills/nixkits-check-updates/SKILL.md · NixKits 仓库的软件包更新适配层——在通用技能 nix-flake-update-check 之上,补充本仓库特有的远端 issue / PR 形态(含与更新重叠的历史先例)、CI 结构(可复用 build-package.yml…
git:20261022.b63b636 · audit A · 28 stars
nixkits-package-upstream SKILL.md skill
kihara777/nixkits · skills/nixkits-package-upstream/SKILL.md · NixKits 的 nixpkgs 上游贡献适配层——在通用技能 upstream-audit 之上,补充本仓特有的环节:13 个包的可行性台账(谁已进 nixpkgs、谁有在途…
git:20261022.d025ef6 · audit A · 28 stars
nixkits-skills SKILL.md skill
kihara777/nixkits · skills/nixkits-skills/SKILL.md · 将 NixKits 技能安装或更新到编码助手目录(opencode、codewhale、codex、openclaw、agents)。支持本地和在线两种安装模式。DeepSeek Harness (dsh) 不再作为安装目标——其…
git:20261020.2e66963 · audit A · 28 stars
nixos-modern-cli SKILL.md skill
kihara777/nixkits · skills/nixos-modern-cli/SKILL.md · 在 NixOS 系统上工作时使用。确保正确使用现代 Nix/NixOS CLI、完整的 shell 能力、sudo 权限和正确的系统维护流程;含 Nix store 路径陷阱与密钥/`path:` input 的仓库外组织方式。
git:20260916.a33a3cf · audit A · 28 stars
nixos-specialisation-tuning SKILL.md skill
kihara777/nixkits · skills/nixos-specialisation-tuning/SKILL.md · 为 NixOS 设计 specialisation 分面(默认 headless + 可选桌面),并在统一内存(UMA)设备上调优 llama.cpp 本地推理。覆盖分面架构、引导菜单与默认面、分面切换后的运行级收敛与用户级…
git:20260922.8c276c0 · audit A · 28 stars
recover-nixos-config SKILL.md skill
kihara777/nixkits · skills/recover-nixos-config/SKILL.md · 当用户误删 /etc/nixos 目录下的文件(flake.nix、flake.lock 等)时,从 Nix store 中恢复。
git:20260606.7dad578 · audit A · 28 stars

Every file in kihara777/nixkits

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