| name | knowledge-curation-skill |
| description | 知识收编技能。将 sources 中知识去重、路由、吸收进 team 内部 references 与 knowledge。 |
知识收编技能
必读
../../references/index.md../../references/07-knowledge-curation.md../../knowledge/canon-map.md
执行模式
模式1：标准收编（~ingest）
扫描 sources/ 目录，执行知识整合。
模式2：批量收编待处理知识（~ingest-pending）
触发条件：收到 ~ingest-pending 指令
执行流程：
Step 1：扫描待处理目录
ls -la ./pending-knowledge/
- 列出所有待处理文件
- 识别文件类型（.txt, .md, 目录等）
Step 2：逐个分析文件
对每个文件执行：
- 读取文件内容
- 提取核心知识点（3-10个）
- 收编前强制5问（必须明确回答，否则拒绝收编）：
- Q1：哪个 agent 会用到这个知识？（必须指定具体 agent 名称，如 script-writer、storyboard-artist）
- Q2：在哪个阶段会用到？（必须指定具体工作流阶段，如 ~write、~storyboard-seedance）
- Q3：现有知识库是否已覆盖？（如已覆盖且无明显增量，拒绝收编）。必须执行
grep -rn "关键概念1\|关键概念2" references/*.md，记录命中文件:行号:摘要。未执行 grep = 自动拒绝
- Q4：目标文件行数是否安全？（执行
wc -l <目标文件>，超 800 行 [WARNING]，超 1200 行 [OVERSIZED] 禁止追加）
- Q5：是否存在多文件命中？（执行
grep -l "核心概念" references/*.md，命中 2+ 文件必须选择主文件并说明理由）
- 判断知识类型：
- 方法论（归属 references/）
- 执行规则（归属 skills/）
- 案例示例（归属 sources/）
- 拒绝收编（无法明确使用场景）
分级示例参考
A级（references/ 核心区）：
- ✅ 「节奏呼吸感四步法」→ ref/16（≥2 agent 用，高频）
- ✅ 「共情四步法」→ ref/14（情绪设计核心）
- ❌ 「70个女频梗库」→ 太具体，应为 C 级
B级（references/ 分镜区）：
- ✅ 「Seedance 景别运镜组合」→ ref/11
- ✅ 「Beat Board 九宫格方法」→ ref/09
C级（sources/）：
- ✅ 「韩国编剧案例分析」→ sources/screenwriting-methodology/
- ✅ 「标题起名30公式」→ sources/screenwriting-methodology/
D级（references/ 进阶区）：
- ✅ 「色彩心理学补充」→ ref/15
- ✅ 「光影叙事新技法」→ ref/17
拒绝：
- ❌ AI 写作 prompt（与工作流无关）
- ❌ 行业报告/职业规划（无 agent 使用场景）
- ❌ 纯理论无可执行规则
Step 3：知识路由分析
为每个知识点生成路由表：
| 知识点 | 归属位置 | 集成方式 | 优先级 | 理由 |
|--------|---------|---------|--------|------|
| ... | references/XX.md | 新增/补充/替换 | A/B/C | ... |
Step 3.5：批量检查点（每 15 个文件）
每处理 15 个文件后输出中间报告：
### 批量检查点 #N
**本批文件**：[文件列表]
**VERIFIED**：X 个
**FAILED**：Y 个
**累计进度**：已处理 M / 总计 T
**暂停条件检查**：
- [ ] FAILED >= 3 → 暂停并报告
- [ ] 目标文件 OVERSIZED → 暂停并报告
- [ ] 主题冲突 → 暂停并报告
Step 4：执行集成
- 使用 Edit 工具更新对应文件
- 遵循"补充优先、替换慎重"原则
- 保持文档结构一致性
- 每次 Edit 后立即执行
grep -n "唯一短语" <文件> 确认写入
- 验证成功输出：[VERIFIED] Edit <文件>
- 验证失败重试一次，仍失败标记 [FAILED] Edit <文件> <原因>
Step 5：记录集成信息（分区存储）
月度详情文件 knowledge/absorption-map-YYYY-MM.md：
## YYYY-MM-DD：批量收编 pending-knowledge
**来源文件**：
- pending-knowledge/1.txt
- pending-knowledge/2.txt
- ...
**集成位置**：
- references/XX.md：新增YY章节
- skills/ZZ/SKILL.md：补充AA规则
- ...
**集成方式**：补充/新增/替换
**优先级**：A/B/C级
索引文件 knowledge/absorption-map-index.md：
- 仅追加一行摘要：
| YYYY-MM-DD | N个文件 | A级×M, B级×N, C级×P | 详见 absorption-map-YYYY-MM.md |
- 更新统计：总收编数、本月收编数、拒绝数
Step 6：移动已处理文件
mkdir -p ./sources/pending-ingested/YYYY-MM-DD/
mkdir -p ./sources/pending-ingested/YYYY-MM-DD/rejected/
mv ./pending-knowledge/[文件名] ./sources/pending-ingested/YYYY-MM-DD/
mv ./pending-knowledge/[文件名] ./sources/pending-ingested/YYYY-MM-DD/rejected/
移动规则：
- ✅ 成功收编：移动到
sources/pending-ingested/[日期]/
- ❌ 拒绝收编：移动到
sources/pending-ingested/[日期]/rejected/，并在报告中说明原因
- 📁 子目录：整体移动，保持结构
Step 7：输出收编报告
## 批量收编报告
### 处理统计
- 总文件数：X
- 成功收编：Y
- 拒绝收编：Z
- 已移动文件：X（成功Y + 拒绝Z）
### 成功收编列表
1. [文件名] → [集成位置] → 已移动到 sources/pending-ingested/YYYY-MM-DD/
- 使用 agent：[agent名称]
- 使用阶段：[工作流阶段]
2. ...
### 拒绝收编列表
1. [文件名]：[拒绝原因] → 已移动到 sources/pending-ingested/YYYY-MM-DD/rejected/
- 原因示例：无法明确使用 agent / 与现有知识重复 / 与工作流无关
2. ...
### 知识集成摘要
- 新增章节：X个
- 补充内容：Y处
- 替换内容：Z处
Step 8：健康检查
收编报告末尾附加健康报告：
### 健康检查报告
| 文件 | 行数 | 状态 | 建议 |
|------|------|------|------|
| references/XX.md | NNN | OK/WARNING/OVERSIZED | — / 评估拆分 / 必须拆分 |
### 重叠检测
- grep -l "核心概念A" references/*.md → [命中文件列表]
- 如命中 2+ 文件，标注需要归属确认
输出
../../knowledge/source-registry.md../../knowledge/absorption-map-index.md../../knowledge/canon-map.md- 批量收编报告（输出到终端）
成功标准
- 新增来源已注册
- 每个来源都有归属 skill
- 吸收结论可追溯
- 批量收编模式：所有文件已移动（成功收编 →
sources/pending-ingested/[日期]/，拒绝收编 → sources/pending-ingested/[日期]/rejected/）
- 收编前强制5问：每个文件都明确回答了使用 agent、使用阶段、是否重复、目标文件行数、多文件命中
- 执行验证：每个 Edit/mv 操作有 [VERIFIED] 标记
- 5问完整：每个文件的5问记录完整，Q3 含 grep 证据
- 健康检查：报告末尾包含健康检查报告
- 零 FAILED：所有操作 VERIFIED，或 FAILED 已说明原因并标记
注意事项
冲突处理
- 如果新知识与现有知识冲突，标注为"需人工判断"
- 不要自动替换现有的核心规则
- 优先补充而非替换
文件移动安全
- 移动前确认文件已成功集成
- 保留原文件名，便于追溯
- 使用日期目录分组，便于管理
质量控制
- 只收编可执行的知识（能执行 > 能解释）
- 只收编可验证的知识（能验证 > 能感受）
- 拒绝一次性灵感，只收编可复用的规则
