From 4c4d1a45e66c848e6064dac2340b773bde4f403b Mon Sep 17 00:00:00 2001 From: root Date: Tue, 14 Apr 2026 17:09:23 +0800 Subject: [PATCH] docs: narrow keyword cleanup skill boundaries --- skills/keyword-cleanup-review/SKILL.md | 36 +++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/skills/keyword-cleanup-review/SKILL.md b/skills/keyword-cleanup-review/SKILL.md index 0b20d5a..bec423d 100644 --- a/skills/keyword-cleanup-review/SKILL.md +++ b/skills/keyword-cleanup-review/SKILL.md @@ -1,11 +1,28 @@ --- name: keyword-cleanup-review -description: 审查和整理本仓库的每日关键词索引和频率统计。当用户需要检查 `data/term_index/term_stats.json`、最近的 `data/term_index/daily/*.json`、`configs/term_aliases.json`、`configs/term_stopwords.json` 或 `configs/filter_context.personal.json`，以提议别名合并、停用词、关注词或 `interest_keywords` 更新（但不直接修改配置）时使用。 +description: 生成 reader 项目的正式关键词 review 输入。当用户需要基于 `data/term_index/term_stats.json`、最近的 `data/term_index/daily/*.json` 和当前 configs 产出 bundle、正式 suggestions JSON，或按需生成审阅 Markdown 供 OpenClaw 汇报和等待确认时使用。不要用于低频清理 review 目录、删除旧产物或直接 apply 配置。 --- # 关键词清理审查 -使用此技能将仓库的关键词统计转化为可审查的清理建议。 +使用此技能将仓库的关键词统计转化为**正式 review 输入**，供 OpenClaw 后续做汇报、确认和 apply 编排。 + +## 角色边界 + +这个 skill 负责： + +- 构建 review bundle +- 生成正式 suggestions JSON +- 按需生成人工审阅 Markdown +- 给 OpenClaw 提供稳定的关键词 review 输入 + +这个 skill 不负责： + +- 清理 `outputs/term_index/review/` 下的旧文件 +- 决定删除哪些历史 bundle / suggestions / markdown +- 直接 apply `configs/term_aliases.json` / `configs/term_stopwords.json` / `configs/filter_context.personal.json` + +低频维护、清理和 dry-run 校验应由 OpenClaw 侧 maintenance SOP 处理，而不是由本 skill 承担。 ## 工作流程 @@ -34,7 +51,7 @@ python scripts/generate_term_cleanup_suggestions.py ^ 默认生成： -- 一份符合模式的 JSON 建议文件（正式建议产物） +- 一份符合模式的 JSON 建议文件（正式建议产物，也是 review / apply 之间唯一正式输入） 如需人工审阅展示稿，再显式加： @@ -56,6 +73,12 @@ python scripts/generate_term_cleanup_suggestions.py ^ - 除非用户明确要求，否则不要直接编辑这些文件 - 除非用户要求修改规则逻辑，否则不要建议直接编辑 `configs/filter_rules.json` +5. 输出交接口径： + +- 将 JSON suggestions 视为正式 review 输入 +- 将 Markdown 视为可选展示层 +- 后续汇报、确认、dry-run apply、正式 apply、收尾清理应由 OpenClaw 编排层继续执行 + ## 审查启发式规则 优先考虑以下决策： @@ -103,7 +126,7 @@ JSON 输出应遵循： 说明：JSON 是 review / apply 之间的唯一正式建议产物，应优先保留。 -## 产物保留策略 +## 产物口径 长期保留： @@ -130,6 +153,11 @@ JSON 输出应遵循： - Markdown 只作为人工展示层，优先按需生成，不默认长期归档 - JSON suggestions 是 review / apply 之间唯一正式建议输入 +说明： + +- “是否删除旧 bundle / 旧 markdown / 旧 suggestions” 不属于本 skill 的正式职责 +- 这类维护动作应由 OpenClaw 侧的 maintenance skill 处理 + ## 仓库说明 当前仓库行为：