chore: update term configs, skill docs and Python 3.10 compat
- term_change_log: record watch term add history - term_watchlist: add initial watch terms from cleanup review - term_aliases: minor update - filter_context.personal: reorganize interest keywords - keyword-cleanup-review skill: clarify JSON as formal artifact, markdown as temp review copy - openclaw_delivery: add Python <3.11 UTC import compat - daily-keyword-index-design: update suggestion artifact semantics
This commit is contained in:
@@ -9,7 +9,7 @@ description: 审查和整理本仓库的每日关键词索引和频率统计。
|
||||
|
||||
## 工作流程
|
||||
|
||||
1. 构建精简的审查数据包:
|
||||
1. 构建精简的审查数据包(临时工作文件):
|
||||
|
||||
```bash
|
||||
python skills/keyword-cleanup-review/scripts/build_review_bundle.py
|
||||
@@ -21,15 +21,32 @@ python skills/keyword-cleanup-review/scripts/build_review_bundle.py
|
||||
- `--top 50`
|
||||
- `--output outputs/term_index/review/keyword-cleanup-bundle.json`
|
||||
|
||||
2. 阅读生成的数据包和建议模式:
|
||||
2. 阅读建议模式:
|
||||
|
||||
- `outputs/term_index/review/keyword-cleanup-bundle.json`
|
||||
- `skills/keyword-cleanup-review/references/suggestion-schema.md`
|
||||
|
||||
3. 生成两份输出:
|
||||
3. 运行 suggestions 生成脚本:
|
||||
|
||||
- 一份简短的供人工审阅的 Markdown 报告
|
||||
- 一份符合模式的 JSON 建议文件
|
||||
```bash
|
||||
python scripts/generate_term_cleanup_suggestions.py ^
|
||||
--bundle outputs/term_index/review/keyword-cleanup-bundle.json
|
||||
```
|
||||
|
||||
默认生成:
|
||||
|
||||
- 一份符合模式的 JSON 建议文件(正式建议产物)
|
||||
|
||||
如需人工审阅展示稿,再显式加:
|
||||
|
||||
```bash
|
||||
python scripts/generate_term_cleanup_suggestions.py ^
|
||||
--bundle outputs/term_index/review/keyword-cleanup-bundle.json ^
|
||||
--emit-markdown
|
||||
```
|
||||
|
||||
这时才会额外生成:
|
||||
|
||||
- 一份简短的供人工审阅的 Markdown 报告(临时展示稿)
|
||||
|
||||
4. 严格保持边界:
|
||||
|
||||
@@ -78,10 +95,41 @@ Markdown 输出应:
|
||||
- 分类别名、停用词、兴趣关键词和关注词建议
|
||||
- 用简短、具体的句子解释理由
|
||||
|
||||
说明:Markdown 主要用于人工临时审阅,不必默认当作长期资产保留。
|
||||
|
||||
JSON 输出应遵循:
|
||||
|
||||
- `references/suggestion-schema.md`
|
||||
|
||||
说明:JSON 是 review / apply 之间的唯一正式建议产物,应优先保留。
|
||||
|
||||
## 产物保留策略
|
||||
|
||||
长期保留:
|
||||
|
||||
- `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`
|
||||
|
||||
默认执行口径:
|
||||
|
||||
- bundle 只作为运行时工作文件,默认只保留当前最新一份
|
||||
- Markdown 只作为人工展示层,优先按需生成,不默认长期归档
|
||||
- JSON suggestions 是 review / apply 之间唯一正式建议输入
|
||||
|
||||
## 仓库说明
|
||||
|
||||
当前仓库行为:
|
||||
@@ -98,5 +146,6 @@ JSON 输出应遵循:
|
||||
|
||||
- 脚本:
|
||||
- `scripts/build_review_bundle.py`
|
||||
- `scripts/generate_term_cleanup_suggestions.py`
|
||||
- 参考文档:
|
||||
- `references/suggestion-schema.md`
|
||||
|
||||
Reference in New Issue
Block a user