write-maintenance-log

维护日志撰写

按统一规范撰写 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 的旧记录（回填 | 提交 | 说明 | 表）
• 格式不统一、行文不规范的历史条目（统一为新格式）

执行流程：

# 1. 提取所有 fix / feat 提交（排除 docs 和 chore(pkgs) 类型）
git log --oneline --all | grep -E 'fix\(|feat\(' | while read hash msg; do
  # 检查是否已在 MAINTENANCE.md 中
  grep -q "$hash" MAINTENANCE.md || echo "MISSING: $hash $msg"
done

# 2. 对每个缺失的提交：
#    a. 按日期分组
#    b. 生成摘要（从 commit message 提取）
#    c. 按格式规范生成条目
#    d. LIFO 插入 MAINTENANCE.md

# 3. 补全已有记录缺失的 commit id
#    a. 解析所有现有记录日期
#    b. 按 ±2h 窗口匹配未关联的提交
#    c. 补充到对应记录的提交表中

# 4. 多语同步并提交

此入口不修改软件版本表中已记录的版本号与 hash 值，仅补充元数据。

记录范围

维护日志覆盖以下类别的变更：