| name | wiki-lint |
| description | 仅用于采用 LLM Wiki 工作流的项目:根目录存在 AGENTS.md 或 CLAUDE.md,并准备采用 raw/ 与 wiki/ 双层结构。若 raw/import.md、wiki/index.md、wiki/log.md 缺失,先初始化。用户要求做重复页、断链、frontmatter、冲突、过期结论、一致性健康检查时触发。 |
Wiki Lint
先读 AGENTS.md 或 CLAUDE.md,并以 wiki-page-standards 作为判定标准。若问题需要补充来源,转到 wiki-import;若需要改写知识页,转到 wiki-ingest 或 wiki-query-synthesis。
触发条件
- 用户要求“做一轮 lint / 健康检查 / 巡检 / 结构审计”
- 用户要求查重、查断链、查 frontmatter、查冲突、查过期结论
- 用户要求批量修复 wiki 结构一致性问题
不应触发
- 用户只是导入来源
- 用户只是新增或更新单一页面,且没有要求全局巡检
前置检查
- 先读
wiki/index.md 获取版图
- 以 wiki-page-standards 为检查基线
- 若发现问题属于“缺来源”或“未落库”,分别转 wiki-import / wiki-ingest
初始化动作模板
开始执行前,按以下顺序初始化:
- 读取
wiki/index.md,获取页面分组与主要条目。
- 明确本轮 lint 范围:
- 建立问题清单容器,按“结构 / 链接 / 来源 / frontmatter / 内容冲突”分类。
- 若本轮包含语义巡检,额外按“分类语义 / 页面模板 / 比较轴”建立子清单。
标准执行清单
- 看
wiki/index.md
- 抽样或全量检查页面
- 记录问题清单
- 判断哪些问题可当场修
- 修复后更新
wiki/index.md 与 wiki/log.md
问题记录模板
### Lint Finding
- Type: duplicate | orphan | stale | conflict | frontmatter | wikilink | semantic-type | template-missing | comparison-axis
- Page: [[PageName]]
- Why: 问题原因
- Fix: 建议修复动作
最小输出模板
### Lint Result
- Scope: all | directory | issue-type
- Findings: N
- Fixed Now: N
- Needs Import: yes | no
- Needs Ingest: yes | no
- Log Updated: yes | no
必查项目
- 重复定义或近似重复页面
- 相互冲突但未标注的内容
- 被新资料覆盖却未更新的旧结论
- 缺少交叉引用的孤立页面
- 高频出现但尚未独立建页的重要实体或概念
- 目录结构混乱、命名不一致、层级失衡
- frontmatter 缺失、错误或过期
- 应用
[[WikiLink]] 的地方仍在混用普通内部链接
entity 是否误写成公司、团队、作者或机构页,而非系统对象页
concept、entity、topic、comparison 是否存在明显类型错放
concept / entity / topic / comparison 是否缺少对应语义模板中的关键区块
comparison 页是否缺少明确 Comparison Axes,或仍在按公司平铺罗列
topic 页是否缺少明确边界,沦为材料堆砌
执行顺序
- 先看
wiki/index.md,理解版图与分组。
- 先按 wiki-page-standards 检查分类语义是否跑偏,尤其是
entity、topic、comparison。
- 再抽查关键页面,识别结构和一致性问题。
- 输出问题清单:问题、页面、原因、建议修复方式。
- 若已实施修复,更新相关页面、
wiki/index.md 与 wiki/log.md。
输出义务
- 至少给出:问题、页面、原因、建议修复方式
- 若发现语义分类问题,应明确指出推荐改为
entity、concept、topic 或 comparison 的哪一类
- 若已修复,必须同步更新相关页面、
wiki/index.md 与 wiki/log.md
- 若发现知识空缺,应指出下一步应进入哪个 skill
- 若本轮只检查未修复,也应写清“未修复原因”
日志格式
完成一轮有效 lint 或修复后,在 wiki/log.md 追加:
## [YYYY-MM-DD] lint | 健康检查摘要
与其他 skills 的协作