| name | index-note |
| description | 索引网络与入口维护工具。Use when 建新索引、网络大修体检处方开具、单篇/批量笔记寻找网状结构归属、执行每日 05/ 每日记录笔记挂载 MOC 时。负责落实卢曼网络连接架构(包含生成修复处方与写入操作)。 |
索引与网络维护 (index-note)
定位
知识网络入口系统与结构健康专家。
核心理念:索引是「入口」而非「分类」——克制、精选、可达。不问“属于哪”,只问“从哪找”。
(03_索引 = MOC,用链接指向 05_每日记录里的原子笔记)
导航与契约(何时读什么)
| 操作模式 | 触发场景 / 核心动作 | 执行前必须 Load 的依据文档 |
|---|
| 模式一:创建索引 | 为全新主题建立枢纽点 | 读 references/index-design-concept.md 判断边界 读 references/output-templates.md 取对应结构 |
| 模式二:网络修复 | 分析体检报告,开具网络缺陷补救处方 | 读 references/output-templates.md 取处方模板 |
| 模式三:内容入网 | 被动或手动为零散笔记建立网络连接 | 读 references/入网流程.md 执行操作判断 |
| 模式四:每日归网 | 每日一键收尾 05_每日记录 最新笔记集散 | 读 references/output-templates.md 取聚合清单方案 |
模式一:创建索引
强制要求:索引用领域名命名(如 索引_营销),不能出现书名/文章名/作者/日期。
- 先读概念字典:加载
references/index-design-concept.md 以确定当前需求应建立的是「概念知识索引」还是含时间线的「项目事件索引」。清晰分辨出索引的主题边界。
- 聚类与筛选入口:搜索全库与该领域相关的卡片。梳理其内在的关键词簇。挑选出能真正作为入口的节点解答搜寻意图,不需要大水漫灌全部罗列。
- 加载模板建档:读取
references/output-templates.md,使用对应的索引骨架输出全新内容节点。
- 加设回溯跳点:确保关联到的底层卡片底部都植入了指向新索引的返回链接(双向可达)。
模式二:网络修复
输入输出:以 network-health 报告为输入分析,出具体检修复可执行处方。本技能不负责重新计算总数和网络层厚数据。
- 读取数据源:从
memory/network-health/ 抽取最近报告,提取:孤岛列表、高频死链、枢纽桥接笔记。
- 甄别深水区隐患(index 层专属判断):
- 检查主题真空:搜索是否有聚成丛的笔记(近3月超5篇同概念)但在 MOC 层没有对应
03_索引,提议「主题缺索引」。
- 扫除沉睡锚:抽验底部存在
SEED 标签且过久未动的节点——提议激活,牵桥搭线,或让其参与下次随机漫游验证。
- 孤岛抢救分析:对抛出的孤岛只负责找到可归属索引或挂钩至相近节点,生搬硬套不进行。
- 提报处方:读取
references/output-templates.md 的【模式二模板】向用户列出详细的修复对策。由用户确认后进行逐一挂载打通。注:因死链通常是移动文件改变的路径,故不直接替用户操作死链。
模式三:内容入网(单篇/批量)
目标要求:用点对点的方式将新游离知识锁在图谱里(≥2路径原则)。执行该模式的核心是将 03_文件夹当做 MOC 系统集散池用。
- 圈定范围:明确当次是被指派一篇文件还是一组文件,作为待入网体待办列表。
- 研读判定规则:加载并读一遍
references/入网流程.md 中对于提取主张/分类 IF-ELSE 的处理手段。
- 落实与宣告:实施对既有索引词条的增添,或者独立生成新的图谱双链交击。完成后,读取
references/output-templates.md 【模式三】区段提供的语法发送《批量入网报告》。
模式四:每日归网 (清理 Inbox)
目标要求:日清日结的兜底动作。让今天未落点的新卡挂接回网络大动脉,防止随风遗落而“脱网”。
- 锁定增量:过滤出当日创建在
05_每日记录/YYYY/MM/YYYYMMDD 以下所有尚未被记下 归网:✅ 的独立文章。
- 快速预读定性:按优先级读取 YAML frontmatter → 标题 → 首段。先抽取
tags(候选索引主信号)和 links(已有连接,归网时跳过重复入网);tags 存在时通常无需读正文即可完成判断;tags 缺失或指向不明时再读首段补充。判定:该卡属于项目范畴?知识范畴?两者兼收并蓄?还是悬而未决不强判归属?
- 加载模板写方案:读取
references/output-templates.md 并严格按【模式四今日归网方案】。将分属同一个索引的文件合并显示,拒绝散沙般的流水列表展示。展示修改后的挂接草图与时间线动作描述。
- 等待确认执行:接受用户指令后,在各卡的尾部统一注入:
← 已归网至 [[索引_XXX]] 伴随 归网:✅ YYYY-MM-DD 的确认字样并在 memory/入网/YYYYMMDD.md 写入处理日志。
- Open Loops 收尾:归网完成后,回看今日
memory/YYYY-MM-DD.md 日志中的所有 Open loops,逐条判断:已闭环 → 划掉;未闭环但下次自然会遇到 → 留在日志;未闭环且「如果不特地去找就会忘」→ 提升到 memory/open loops.md(附来源笔记链接)。闭环后从 open loops.md 删除,不存档。
质量与审查 CheckList(必做)
附录:批量归网自动化扩展 (资产化实现)
对于通过确认后累积的大规模未闭环归网笔记队列,可直接使用底盘提供的脚手架完成幂等闭环操作,无需模型自己逐字复写:
- 执行方法:确保确认清单架构完好后,在终端执行:
python3 ".agents/skills/index-note/scripts/batch_network_integration.py"
- 脚本会主动找到已在清单中的映射目标,自动穿透完成逆向链接填充以及结尾印章加注,已被识别过的节点将会无害略过。