jw-agenda-planning-sync — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited jw-agenda-planning-sync (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
检查 tasks 总待办、年规划、月规划、周规划、日计划之间的一致性,发现偏差后生成同步建议,仅在用户确认后批量更新。
全层级检查原则:本 Skill 覆盖规划体系的所有层级(tasks/TODO → 年 → 月 → 周 → 日),确保各层之间的任务内容对齐和完成状态同步。其他 Skill 在运行时会做各自方向的级联更新(daily-todo/weekly-plan 从上往下,daily-log/weekly-review 从下往上),本 Skill 作为事后全局一致性检查,捕捉遗漏的偏差。
建议运行时机见本 Skill 的 `assets/conventions.md` 的「Planning Sync 建议时机」。
本 Skill 仅依赖用户 workspace 下存在 jw-agenda 根目录(默认 jw-agenda-data,可经 workspace 根目录的 .jw-agenda.json 或 jw-agenda.json 配置)及子目录 monthly、weekly、daily、tasks。约定与脚本已随本 Skill 安装,无需用户另行复制。先按 conventions 解析 jw-agenda 根目录。
开始前读取本 Skill 的 `assets/conventions.md` 获取文件命名、路径和日期规则。
使用本 Skill 的 assets/scripts/date_utils.py 计算日期和周数,然后按层级从上到下读取:
{agendaRoot}/tasks/TODO.md 及其他 todo-*.md{agendaRoot}/yearly/YYYY-plan.md 或类似路径{agendaRoot}/monthly/YYYY-MM-plan.md(当前月,如 2026-02-plan.md){agendaRoot}/weekly/Week{W}-plan.md{agendaRoot}/daily/{今天日期}-todo.md(可选:最近 3–7 天的 todo 和 log)缺失的层级跳过,向用户说明(见 Error Handling)。
从三个维度、跨所有可用层级检查一致性:
维度 1 — 任务内容对齐(从上到下):
维度 2 — 完成状态同步(从下到上):
[x])的任务,周规划中是否也已标记完成?维度 3 — 新增/变更追踪:日执行中新增的任务是否需补入周/月规划?取消/推迟的任务是否在各层级都已同步修正?
内容对齐的比对策略(维度 1 与 2 的判定方式):
- [ ] / - [x]、来源标记如 *(来自规划)* 等)后,对前后空格与换行做规范化;若两条目的核心描述一致(去掉标记后文本相同或一方包含另一方关键词子串),则视为「同一任务」。不要求精确逐字匹配,以便容忍用户微调措辞。[x] vs [ ])。若日已勾选而周未勾选,或周已勾选而日未勾选,则记为偏差;建议以日执行为准(见 conventions 中的冲突裁决策略)同步到周/月。| 级别 | 含义 | 示例 |
|---|---|---|
| ⚠️ 需行动 | 影响计划执行,建议立即同步 | 日已完成但周未勾选、周有今日任务但日 todo 未包含 |
| ℹ️ 信息性 | 不影响执行,供参考 | 日 todo 有额外临时任务未在规划中、日/周中的项来自 tasks 目录下 todo 开头清单(属合理来源) |
每条偏差附带:涉及的文件路径、具体位置、建议操作。
输出结构化的建议清单(使用 assets/sync-report-template.md 格式)。
| 情况 | 处理 |
|---|---|
| 某层级文件不存在 | 跳过该层级,仅检查可用的层级 |
| tasks/TODO.md 不存在 | 跳过总待办检查 |
| 年规划不存在 | 跳过年规划检查(年规划为可选) |
| 仅有一个层级存在 | 无法做跨层对比,告知用户并建议先生成缺失的规划 |
| 无偏差 | 汇报「各层规划一致,无需同步」 |
| 用户不确认任何建议 | 汇报「未做任何修改」,不执行任何写操作 |
assets/sync-report-template.md:同步报告输出模板assets/conventions.md:约定assets/scripts/date_utils.py:日期计算脚本~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.