用途:把新来源加入 wiki。来源可以是文件路径、URL 或粘贴文本;流程为读取全文、先向用户呈现 3-5 条要点及涉及的实体/概念、确认是否与现有内容矛盾,再生成 slug 并写入摘要页。
前置条件:从当前目录向上或常见位置(~/wikis/)查找 SCHEMA.md;找不到则提示先运行 wiki-init。需从 SCHEMA.md 读取 wiki 根路径、frontmatter 格式、交叉引用约定、日志格式与索引分类;链接样式读 link_style,缺失时默认 obsidian 并用 [[slug]]。
主要能力:撰写 wiki/pages/<slug>.md 摘要页(含 Summary、Key Takeaways、Entities & Concepts、Relation to Other Wiki Pages);写作时按 SCHEMA 的 Citations 约定加脚注,引用目标可为 slug 引用、raw/<file> 或 URL,可文本寻址的来源需带行号范围 L<start>-<end>;更新或新建实体/概念页;执行反向链接审计,扫描 wiki/pages/ 中提及相关实体但未链接的页面并补链;做矛盾检查,阻塞性冲突写入 contradiction-check: failed 并暂停提交,软性张力仅记录;用 python bin/generate-index.py 重新生成索引,更新 overview.md,并按约定记录操作(git wiki 建议提交,非 git 追加到 wiki/log.md)。
限制与注意:不得手改索引;不得写指向不存在页面的 [[slug]];摘要须为自行综合而非改写摘要;页面应就地更新而非追加时间线式更新;提交前须清除所有 contradiction-check: failed。具体命令与字段以 SCHEMA.md 为准。