docs: narrow keyword cleanup skill boundaries

This commit is contained in:
root
2026-04-14 17:09:23 +08:00
parent b8727f1885
commit 4c4d1a45e6
+32 -4
View File
@@ -1,11 +1,28 @@
--- ---
name: keyword-cleanup-review 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` - 除非用户要求修改规则逻辑,否则不要建议直接编辑 `configs/filter_rules.json`
5. 输出交接口径:
- 将 JSON suggestions 视为正式 review 输入
- 将 Markdown 视为可选展示层
- 后续汇报、确认、dry-run apply、正式 apply、收尾清理应由 OpenClaw 编排层继续执行
## 审查启发式规则 ## 审查启发式规则
优先考虑以下决策: 优先考虑以下决策:
@@ -103,7 +126,7 @@ JSON 输出应遵循:
说明:JSON 是 review / apply 之间的唯一正式建议产物,应优先保留。 说明:JSON 是 review / apply 之间的唯一正式建议产物,应优先保留。
## 产物保留策略 ## 产物口径
长期保留: 长期保留:
@@ -130,6 +153,11 @@ JSON 输出应遵循:
- Markdown 只作为人工展示层,优先按需生成,不默认长期归档 - Markdown 只作为人工展示层,优先按需生成,不默认长期归档
- JSON suggestions 是 review / apply 之间唯一正式建议输入 - JSON suggestions 是 review / apply 之间唯一正式建议输入
说明:
- “是否删除旧 bundle / 旧 markdown / 旧 suggestions” 不属于本 skill 的正式职责
- 这类维护动作应由 OpenClaw 侧的 maintenance skill 处理
## 仓库说明 ## 仓库说明
当前仓库行为: 当前仓库行为: