kb-skills/.planning/ROADMAP.md

Roadmap: kb-skills

Milestones

• ✅ v1.0 Pipeline Architecture - Phases 1-4 (shipped 2026-03-15)
• 🚧 v1.1 Architecture Refactor - Phases 5-6 (in progress)

Phases

✅ v1.0 Pipeline Architecture (Phases 1-4) - SHIPPED 2026-03-15

Phase 1: Foundation

Goal: 项目基础设施和状态管理 Plans: 3 plans

Plans:

• 01-01: WorkflowStateManager 状态管理
• 01-02: LinkParser URL 解析
• 01-03: IdempotencyChecker 幂等检查

Phase 2: Adapters

Goal: 平台元数据适配器 Plans: 2 plans

Plans:

• 02-01: BilibiliAdapter B站适配器
• 02-02: ZhihuAdapter 知乎适配器

Phase 3: Processors

Goal: 管道处理器架构 Plans: 3 plans

Plans:

• 03-01: BaseProcessor 基类
• 03-02: 具体处理器实现
• 03-03: Schema 验证

Phase 4: Pipeline

Goal: 处理器编排和 CLI Plans: 2 plans

Plans:

• 04-01: Pipeline 编排引擎
• 04-02: CLI process 命令

🚧 v1.1 Architecture Refactor (In Progress)

Milestone Goal: 简化代码结构和优化文件组织 — 统一中间目录、添加归档步骤、整合元数据技能和 Pipeline 模块

Phase 5: 归档与目录优化

Goal: 统一中间目录结构，添加自动归档步骤，优化最终目录布局 Depends on: Phase 4 Requirements: INT-01, INT-02, INT-03, ARC-01, ARC-02, ARC-03, ARC-04, OUT-01, OUT-02, OUT-03, OUT-04 Success Criteria (what must be TRUE):

1. 所有分析任务的中间文件统一存放在 ~/work/intermediate/analysis/{platform}_{content_id}/
2. 分析完成后 md 文件自动复制到按平台分组的最终目录
3. 最终目录结构为 {KB_ARCHIVE_PATH}/{platform}/{YYYYMMDD}_{content_id}_analysis.md
4. 归档时检测重复文件，询问用户是否覆盖
5. 不自动清理中间文件（用户手动维护） Plans: 3 plans

Plans:

• 05-01-PLAN.md — 中间目录统一和配置 (INT-01, INT-02, INT-03)
• 05-02-PLAN.md — ArchiveProcessor 归档处理器 (ARC-01, ARC-02, ARC-03, ARC-04)
• 05-03-PLAN.md — 最终目录结构验证和测试 (OUT-01, OUT-02, OUT-03, OUT-04)

Phase 6: 代码整合

Goal: 将独立的元数据技能和 Pipeline 模块整合进 kb-workflow，消除 sys.path 操作，建立标准 Python 包结构 Depends on: Phase 5 Requirements: MET-01, MET-02, MET-03, MET-04, MET-05, PIP-01, PIP-02, PIP-03, PIP-04 Success Criteria (what must be TRUE):

1. kb-bilibili-metadata 和 kb-zhihu-metadata 代码移入 kb-workflow/metadata/
2. kb_pipeline/ 代码合并入 kb-workflow/ 保持 processors/, platforms/, schemas.py 结构
3. 所有导入路径更新指向新位置，CLI 正常工作
4. 原独立的 kb-bilibili-metadata、kb-zhihu-metadata、kb_pipeline 目录已删除
5. 所有 sys.path 动态操作已删除或重构
6. Pipeline 类可从 kb_workflow.pipeline 包级别导入 Plans: 3 plans

Plans:

• 06-01-PLAN.md — 元数据技能整合 (MET-01, MET-02, MET-03, MET-04, MET-05)
• 06-02-PLAN.md — Pipeline 模块整合 (PIP-01, PIP-02, PIP-03, PIP-04)
• 06-03-PLAN.md — Gap Closure: 消除 sys.path 操作和补充 Pipeline 导出 (MET-05, PIP-04)

Progress

Execution Order: Phases execute in numeric order: 1 → 2 → 3 → 4 → 5 → 6

Phase	Milestone	Plans Complete	Status	Completed
1. Foundation	v1.0	3/3	Complete	2026-03-15
2. Adapters	v1.0	2/2	Complete	2026-03-15
3. Processors	v1.0	3/3	Complete	2026-03-15
4. Pipeline	v1.0	2/2	Complete	2026-03-15
5. 归档与目录优化	v1.1	3/3	Complete	2026-03-16
6. 代码整合	v1.1	2/3	In Progress	-