feat: add keyword maintenance skill
This commit is contained in:
root
@@ -0,0 +1,128 @@
|
||||
---
|
||||
name: reader-keyword-maintenance
|
||||
description: 维护 reader 项目的关键词 review 目录与低频清理 SOP。当用户要求清理或整理 reader 的关键词 review 目录、控制哪些产物长期保留、检查 suggestions JSON 是否可 apply、或执行“只保留当前 bundle / 仅保留最近少量 suggestions JSON / 删除旧 markdown”等低频维护动作时使用。不要用于正式关键词 review 生成，不要用于 reader 日报主链路。
|
||||
---
|
||||
|
||||
# Reader Keyword Maintenance
|
||||
|
||||
这个 skill 负责 reader 关键词治理里的**低频维护动作**，目标是把清理策略、展示稿生成、dry-run 校验和 review 目录维护从 reader 主链路里拆出来，由 OpenClaw 单独承接。
|
||||
|
||||
## 角色边界
|
||||
|
||||
这个 skill 负责：
|
||||
|
||||
- 检查 `outputs/term_index/review/` 当前有哪些产物
|
||||
- 判断哪些 review 产物应长期保留、短期保留或可清理
|
||||
- 用 `apply_term_suggestions.py --dry-run` 做 apply 前校验
|
||||
- 执行低频清理和收尾动作
|
||||
|
||||
这个 skill 不负责：
|
||||
|
||||
- 正式生成关键词 review 建议
|
||||
- 充当 alias / stopword 正式 review 决策器
|
||||
- 替代 reader 侧的 `keyword-cleanup-review`
|
||||
|
||||
如果用户要的是“做一轮正式关键词 review / 生成正式 suggestions JSON”，应由 OpenClaw 去调用 reader 侧 `keyword-cleanup-review`，而不是由本 skill 直接承担。
|
||||
|
||||
## 适用场景
|
||||
|
||||
当用户要求以下事情时使用：
|
||||
|
||||
- 查看或解释 `reader/outputs/term_index/review/` 下有哪些文件
|
||||
- 清理旧的 review bundle、old suggestions、old markdown
|
||||
- 只保留当前 bundle 或最近少量 suggestions JSON
|
||||
- 检查 suggestions JSON 是否可被 `apply_term_suggestions.py` 消费
|
||||
- 执行一次人工 review 准备动作，但不改变 reader 主链路设计
|
||||
|
||||
不要用于：
|
||||
|
||||
- 日报正式生产运行
|
||||
- 生成 daily term index / term_stats 主链路
|
||||
- 自动写配置作为默认行为
|
||||
- 修改 reader 仓库里的主 SOP 作为低频维护动作的默认入口
|
||||
- 正式生成 alias / stopword / interest / watch 建议
|
||||
|
||||
## 默认口径
|
||||
|
||||
长期保留：
|
||||
|
||||
- `data/term_index/daily/*.json`
|
||||
- `data/term_index/term_stats.json`
|
||||
- `configs/filter_context.personal.json`
|
||||
- `configs/term_watchlist.json`
|
||||
- `configs/term_aliases.json`
|
||||
- `configs/term_stopwords.json`
|
||||
- `configs/term_change_log.json`
|
||||
|
||||
正式建议产物（短期保留）：
|
||||
|
||||
- `outputs/term_index/review/term-cleanup-suggestions-YYYY-MM-DD.json`
|
||||
|
||||
临时工作文件 / 展示层：
|
||||
|
||||
- `outputs/term_index/review/keyword-cleanup-bundle.json`
|
||||
- `outputs/term_index/review/term-cleanup-suggestions-YYYY-MM-DD.md`
|
||||
|
||||
更细的保留/清理判断，读取：
|
||||
|
||||
- `references/cleanup-policy.md`
|
||||
|
||||
## 固定 SOP
|
||||
|
||||
### 1. 检查 review 目录
|
||||
|
||||
- 查看 `outputs/term_index/review/` 当前有哪些文件
|
||||
- 分类成：
|
||||
- 长期保留
|
||||
- 短期保留
|
||||
- 临时工作文件
|
||||
|
||||
### 2. 准备人工审阅
|
||||
|
||||
- 确认最新 bundle 存在
|
||||
- 确认最新 suggestions JSON 存在
|
||||
- 如需正式生成 suggestions 或 Markdown 展示稿，应转到 reader 侧 `keyword-cleanup-review`
|
||||
|
||||
### 3. dry-run 校验 apply
|
||||
|
||||
- 仅通过 `scripts/apply_term_suggestions.py --dry-run` 校验 suggestions JSON 是否可消费
|
||||
- 不直接落配置
|
||||
|
||||
### 4. 清理 review 产物
|
||||
|
||||
- 删除旧 markdown 展示稿
|
||||
- 默认只保留当前/latest bundle
|
||||
- 保守清理旧 suggestions JSON
|
||||
- 不碰 facts/state/config files
|
||||
|
||||
## 常用动作
|
||||
|
||||
### 1. 验证 suggestions JSON 能否被 apply 消费
|
||||
|
||||
```bash
|
||||
cd /home/ubuntu/zhu/github/reader && \
|
||||
/usr/bin/python3.11 scripts/apply_term_suggestions.py \
|
||||
--suggestions outputs/term_index/review/term-cleanup-suggestions-YYYY-MM-DD.json \
|
||||
--accept-interest "Claude Code" \
|
||||
--dry-run
|
||||
```
|
||||
|
||||
## 清理策略
|
||||
|
||||
保守策略：
|
||||
|
||||
- bundle：默认只保留当前最新一份
|
||||
- markdown：默认不归档，需要时现生成
|
||||
- suggestions JSON：只保留最近少量几份或已应用过的记录
|
||||
|
||||
## 维护原则
|
||||
|
||||
- 优先减少中间产物，不要让 review 工作文件变成长期资产
|
||||
- JSON suggestions 是 review / apply 之间唯一正式输入
|
||||
- Markdown 只是展示层，不是系统真相
|
||||
- 任何清理动作前，先确认不会影响当前待审阅或待 apply 的 suggestions JSON
|
||||
- 正式关键词 review 的生成入口不在这里，而在 reader 侧 `keyword-cleanup-review`
|
||||
|
||||
执行清理或 review-prep 前，先读取：
|
||||
|
||||
- `references/maintenance-checklist.md`
|
||||
Reference in New Issue
Block a user