sunday-note-lint

name	sunday-note-lint
description	检查知识库健康度并编排 lint 维护。用于用户明确要求 lint、清理、合并、去重、修复或维护 Wiki 与个人上下文时，生成维护计划、写维护日志、创建 worker subagent 执行具体写入任务并复核结果；主 agent 不直接改写普通 Wiki 正文。

Lint

工作流

1. 读取用户指定范围、路径映射、写入边界和相关规则；不默认扫描全库。
2. 必要时运行 scripts/lint_headers.py --scope <文件或目录>；需要完整入口导航审计、Markdown link 审计、零入链或未解析链接报告时，运行 scripts/audit_reachability.py --entry <入口> --scope <范围>。
3. 按检查项生成本轮维护计划，并写入 30_知识库/知识库维护日志.md 的 lint 运行段。
4. 为每个具体写入任务创建一个 worker subagent；同一文件任务串行执行。
5. 复核文件 diff、验证结果和遗留问题，更新维护日志并输出汇总。

检查项

• 主题重复、缺主要说明页、孤立页、未入 index、入口不可达或链路过深。
• header 字段、日期、计数、sources、topic、keywords、来源冲突和跨页矛盾。
• 弱链接、低个人增量、通用搜索可替代内容、过期内容、上下文拖累。
• Raw / Routine / Wiki / Journal / Schema 边界混淆。
• 结构性空话和过程性写入包装；正则命中只是候选，需结合上下文判断是否缺少事实、判断、关系或约束。
• 个人上下文缺失、过期、空白、分散或混入未确认推断；候选必须来自用户明确表达、Routine / Project / Wiki 中稳定重复出现的事实，或用户确认过的判断。
• Wiki 正文中的可见维护标记应迁入 %% agent ... %% 注释块。

输出

先按确定性分组输出问题：

### 明确问题
| 问题 | 类型 | 严重程度 | 证据 | 建议动作 |
|---|---|---|---|---|

### 候选问题
| 问题 | 类型 | 严重程度 | 证据 | 建议动作 |
|---|---|---|---|---|

### 需人工判断
| 问题 | 类型 | 严重程度 | 证据 | 建议动作 |
|---|---|---|---|---|

再输出维护计划：

| task_id | 目标 | 涉及文件 | 动作 | 风险 | 验证方式 | 执行方式 |
|---|---|---|---|---|---|---|

维护日志使用单个 lint 运行段：

## lint-YYYYMMDD-HHMM

### 计划
| task_id | 目标 | 涉及文件 | 动作 | 风险 | 验证方式 |
|---|---|---|---|---|---|

### 执行记录
| task_id | 执行者 | 状态 | 变更 | 验证 | 遗留问题 |
|---|---|---|---|---|---|

执行规则

• 用户明确触发 lint 维护时，本轮自动生成计划、写维护日志、调度 worker subagent 并复核结果。
• 主 agent 只直接维护 知识库维护日志.md；普通 Wiki 正文、index 和个人上下文写入由 worker 执行。
• Worker 使用 agent_type="worker"、fork_context=false；只接收 task_id、目标文件、证据文件、写入范围、禁止事项、验证方式和预期输出。
• 主 agent 的 lint 编排循环不自动触发 ingest、query 或 audit；worker 可在任务明确要求且范围受限时使用相关 skill。
• 高风险、证据不足、需要用户个人判断或涉及删除 / 归档的任务标记为 blocked，不强行修改。
• 来源覆盖表只作为本轮审计产物；长期维护日志只保留异常项、部分承接项、待确认项和 blocked 项。
• query_count 只是弱信号；合并、归档或降级必须同时有低个人增量、入口承接弱、内容过时或来源问题等证据。
• 空白 scaffold 页面只作为待填候选；已有正文或用户指定检查时，才判断其个人上下文质量。
• index 检查以 Obsidian [[wikilink]] 为准。
• scripts/lint_headers.py 只做粗筛：header、日期、计数、来源、topic、keywords、重复 topic、index 链接、入口可达性和 body-scan 候选；不做正文语义判断，不判断个人增量，不替代最终 lint 判断。
• scripts/audit_reachability.py 只在需要完整导航审计时运行；zero_inlinks 是候选问题，不单独作为明确问题。