Tyou 文档同步

扫描范围、映射、写入开关、备份和脱敏规则由根目录 wiki-sync.yaml 定义。先报告源码/工具证据与文档差异，再在用户授权的任务范围内修正文档；不自动修改业务代码。

命令

# 只读覆盖扫描
powershell -ExecutionPolicy Bypass -File .agents/skills/wiki-sync/scripts/wiki-sync.ps1 scan

# 只读映射缺口扫描（不比较正文语义）
powershell -ExecutionPolicy Bypass -File .agents/skills/wiki-sync/scripts/wiki-sync.ps1 diff

# 生成报告属于写操作
powershell -ExecutionPolicy Bypass -File .agents/skills/wiki-sync/scripts/wiki-sync.ps1 report -Output wiki-sync-report.md -Write

模式

scan

检查源码、README/Books、skill references、AGENTS、skills 和 Project Knowledge 的覆盖关系与明显缺口。

diff

脚本 diff 只报告映射缺口。正文语义差异需由本 skill 对照源码和文档查明，不能用脚本的 covered 或退出码证明内容同步。

sync

在当前任务已授权修改文档时实施受控修正：

1. 以源码和工具实际行为为准。
2. 根据本次改变的规则或事实定位消费者和相关文档；映射变化才运行覆盖扫描，命令审批策略变化才检查 .codex/rules/*.rules。不因普通文档修正展开全仓库核验。
3. 项目到文档方向先确认差异，不无条件覆盖；文档到项目方向只生成待办，不自动改业务代码。
4. 报告或备份写入必须满足 write_enabled 或显式 -Write。

安全约束

• 不写敏感信息、绝对私有路径或临时日志到 README/Books。
• 不把外部通用参考直接写成 Tyou 规则；只记录已验证适用于本项目的结论。
• Project Knowledge 按 tyou-dev/references/memory-workflow.md 维护；仅存无法由 topic reference 替代的项目知识，不在只读扫描中写回日期，不镜像官方 Codex Memories 或 Astra 任务笔记。

输出

文档同步报告
- 范围：
- 源码/工具证据：
- 已查文档：
- 差异：
- 已修改：
- 仍需确认：