| name | docs-pull |
| description | 按 knowledge-links.yaml 从本地 path 同步到联邦槽位（system/application-{APPNAME}/ 或 company/system-{SYSNAME}/），并追加槽位 changelogs/CHANGE-LOG.md。 用户提到 /docs-pull、从应用/系统本地仓回拉到联邦槽位、同步槽位、按 knowledge-links 拉取时，使用本技能。 分流：推送中央规约到应用库 → docs-push；overview 蒸馏 / 归档 / SDD → 对应技能。 推进见 light-flow-actions（C/M/S/F，无 G）与 references/gates.md。
|
docs-pull
输出硬约束（P0）
- 当前单元：单个
application-{app} 或 system-{sys} 槽位。
- 轻流程：参数向导 → 风险校核 →
C/M/S/F（无 G、不绑意图澄清）→ light-flow-actions.md；细节 gates.md。参数未收口前不得执行同步。
--all 也须先处理并校核一个当前槽位；未收敛前不得静默推进后续槽位。- 路径不存在、非 Git 工作区、目标
.docsconfig 缺失、槽位不存在、links 字段不完整等风险须先确认；未确认不得继续。
- 同步后必须补写槽位
changelogs/CHANGE-LOG.md；未完成追溯不得视为单元完成。
边界
| 负责 | 不负责 |
|---|
| application→system、system→company 槽位同步；槽位 CHANGE-LOG 追溯 | docs-push 中央规约下发；docs-distill / docs-archive / SDD 正文；远端 clone / 分支拉取 |
不这样用
- 不把
docs-push 中央规约复制主路径收成 docs-pull
- 不在
--all 下一口气静默同步所有槽位
- 不做远端 clone、分支拉取或跨仓初始化
路由
最少输入
knowledge-links.yaml--app / --sys-name / --all 三者之一- 本地
path 可访问；槽位已由 docs-link 创建
产出与脚本
bash agent/skills/docs-pull/scripts/pull-slots.sh --app <app_name>
bash agent/skills/docs-pull/scripts/pull-slots.sh --sys-name <sys_name>
bash agent/skills/docs-pull/scripts/pull-slots.sh --all
评测
evals/evals.json、grader.md（P0 断言为准）。重点：单槽位停顿、--all 批量须确认、CHANGE-LOG 须跟随同步。
