| name | docs-change |
| description | 从 Git、CHANGELOG*、本地 mtime 三源采集变更，写入 {output_dir}/CHANGE-LOG.md，文末保留增量基线注释。 用户提到 /docs-change、变更聚合、「记录改动」「最近改了什么」时，使用本技能。 分流：INDEX / 实体 / 归档 / 术语为主路径 → docs-indexing、docs-build、docs-archive、docs-upgrade。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。
|
docs-change
输出硬约束（P0）
- 当前单元：单个
CHANGE-LOG.md 输出。
- 轻流程：参数向导 → 轻量校核 →
C/M/S/F（无 G、不绑意图澄清）→ light-flow-actions.md；细节 gates.md。参数未收口前不得写 CHANGE-LOG.md 或更新文末基线。
.docsconfig 无效时必须中止；不得启发式猜路径继续。- 时间基准、
--output、单源采集等语义歧义须先给结论、推荐与数字选项；未确认不得执行。
- 当前输出单元校核完成前，不得自动推进下一输出目录。
边界
| 负责 | 不负责 |
|---|
| 三源聚合、倒序插入、文末基线 | index、KNOWLEDGE_INDEX、overview 归档、全库术语；docs-indexing / docs-build / docs-archive / docs-upgrade |
不这样用
- 不把旧「环境准备五步」当唯一主线；主线是参数收口后处理当前输出单元
- 不在无
.docsconfig 时猜测 **/changelogs/ 继续写入
- 不把全量/增量 INDEX、实体刷新、overview 归档收成
docs-change
路由
最少输入
- 有效
.docsconfig
--since 或可确定的基线策略--output 已收口或接受默认- 若仅采单源，来源范围已确认
产出与脚本
- 正式：
{output_dir}/CHANGE-LOG.md（默认 ${DOC_ROOT}/changelogs/）
- 原始：
{output_dir}/.raw/（change-indexing.sh）
- 收敛后动作见 light-flow-actions.md（本技能有
S，无 G）
- 下游：docs-indexing / docs-build 可消费 CHANGE-LOG（详 workflow）
agent/skills/docs-change/scripts/change-indexing.sh --since "yyyy-MM-dd HH:mm:ss.SSS"
评测
evals/evals.json、grader.md（P0 断言为准）。重点：.docsconfig 硬门禁、基线歧义确认、单输出单元停顿、不得静默降级。
