三方数据一致性智能审计

基于 GitHub 作为事实来源，自动审计 Flatnotes 知识库与 Tasks.md 看板的一致性，检测过时笔记、缺失链接和项目漂移，生成可执行的修复计划。

基本信息

• 技能名称?flatnotes-tasksmd-github-audit
• 中文名称?三方数据一致性智能审计
• 作者?branexp
• 分类?专业技能
• 版本?v1.0.0
• 标签?productivity, project-program-management, automation, docs, git, backend, devops

使用方法

使用说明
核心用法
该 Skill 是一个专门用于维护个人/团队知识管理系统一致性的审计工具。它通过三方数据交叉验证来确保信息同步：以 GitHub 作为权威数据源，对比 Flatnotes（知识库）和 Tasks.md（看板系统）的状态。用户只需运行 node scripts/audit.mjs --since-days 30 --write 即可生成完整的漂移报告。
审计覆盖三大维度：

1. 看板健康度 ：检查 Tasks.md 的泳道规则（如 WIP 限制、优先级分布）、卡片格式规范、阻塞状态标注等
2. 项目完整性 ：验证 Flatnotes 中每个活跃项目是否具备完整的笔记结构（Overview/Research/Plan/Log）
3. GitHub 事实核对 ：将开源 PR 状态与 Tasks 卡片进行匹配，确保已合并的工作有记录、进行中的工作有追踪
   显著优点
   零依赖设计 ：仅使用 Node.js 内置模块，无 npm 包引入供应链风险
   非侵入式审计 ：默认只读模式，不修改任何数据，风险可控
   结构化输出 ：同时生成 Markdown 人读报告和 JSON 机器解析格式
   智能匹配算法 ：通过 PR URL、编号、标题子串等多维度启发式匹配，降低人工核对成本
   环境自适应 ：支持通过环境变量覆盖默认路径，适配不同部署场景
   潜在缺点与局限性
   外部工具强依赖 ：必须预装并认证 gh CLI，否则 GitHub 检查将被跳过
   启发式匹配非完美 ：PR 与卡片的关联依赖文本相似度，可能存在误报或漏报
   单用户场景设计 ：路径硬编码为 /home/ds/... ，多用户共享环境需手动配置
   无实时同步能力 ：仅为周期性审计工具，非持续集成的实时钩子
   修复功能有限 ：自动修复仅限于安全的元数据补充，结构性变更需人工确认
   适合的目标群体
   使用 Flatnotes + Tasks.md 组合管理项目的个人开发者或小型团队
   追求"GitHub 即事实来源"工作流的工程师
   需要定期知识库健康检查的维护者
   对供应链安全敏感、偏好零依赖工具的用户
   使用风险
   文件系统访问 ：需读取用户配置目录下的全部 Markdown 文件，敏感笔记内容会被解析
   GitHub API 调用 ：通过 gh CLI 发起网络请求，可能触发企业环境的出站流量审计
   报告泄露风险 ：生成的审计报告包含项目结构、PR 链接等元数据，分享前需脱敏审查
   路径遍历隐患 ：虽当前版本使用常量路径，但环境变量注入仍需使用者自行校验