笔记系统审计

技能简介

该技能用于审计 Tasks.md 看板与 Flatnotes 笔记系统之间的一致性，以 GitHub 作为事实来源，检测过期卡片、缺失链接和状态漂移，生成审计报告及可选修复方案。

业务背景

笔记系统审计帮助团队保持任务看板与项目文档的同步。它能自动发现Tasks.md中过期未更新的卡片、Flatnotes里缺失的项目笔记，以及GitHub PR状态与实际进度不符的情况，减少因信息分散导致的协作断层，让项目经理快速掌握真实工作全貌。

落地案例：某产品经理每周五运行审计指令，系统自动扫描本周活跃的5个项目：检查Tasks.md泳道是否超WIP限制，核对每个项目的Overview/Research/Plan/Log四篇笔记是否齐全，再比对GitHub上已合并的PR是否在看板中正确归档。10分钟后生成Markdown报告，标出2张状态漂移的卡片和1个缺失的Plan笔记，一键确认后即可自动修复。

能做什么

• 检查 Tasks.md 看板结构合规性（泳道设置、WIP限制、卡片格式）
• 验证 Flatnotes 项目笔记完整性（Overview/Research/Plan/Log）
• 比对 GitHub PR 状态与 Tasks 卡片对应关系
• 输出 Markdown/JSON 双格式审计报告
• 支持安全自动修复（创建缺失笔记、调整卡片位置等）

使用说明

安装前提

1. 确保已安装 Node.js 环境
2. 安装并配置 GitHub CLI：gh auth login
3. 克隆技能仓库至本地工作区

执行审计

node skills/flatnotes-tasksmd-github-audit/scripts/audit.mjs --since-days 30 --write

输出文件：

• tmp/flatnotes-tasksmd-audit.md — 可读报告
• tmp/flatnotes-tasksmd-audit.json — 结构化数据

环境变量覆盖（可选）

• TASKS_ROOT — Tasks.md 根目录
• FLATNOTES_ROOT — Flatnotes 数据目录

输入与输出

见下方输入与输出表格。

风险提示

• 默认仅生成报告，不会修改任何数据
• 删除或重命名操作需人工确认后执行
• 未认证 GitHub CLI 时，PR 比对环节将标记为跳过
• 修复建议基于启发式匹配，关键决策仍需人工复核

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/branexp/flatnotes-tasksmd-github-audit/SKILL.md
来源类型：GitHub 仓库