diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index 43ffdd8..ab249e9 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -67,21 +67,34 @@ Deferred to future release. ## Traceability -Updated during roadmap creation. - | Requirement | Phase | Status | |-------------|-------|--------| -| INT-01 ~ INT-03 | Phase 5 | Pending | -| ARC-01 ~ ARC-04 | Phase 5 | Pending | -| OUT-01 ~ OUT-04 | Phase 5 | Pending | -| MET-01 ~ MET-05 | Phase 6 | Pending | -| PIP-01 ~ PIP-04 | Phase 6 | Pending | +| INT-01 | Phase 5 | Pending | +| INT-02 | Phase 5 | Pending | +| INT-03 | Phase 5 | Pending | +| ARC-01 | Phase 5 | Pending | +| ARC-02 | Phase 5 | Pending | +| ARC-03 | Phase 5 | Pending | +| ARC-04 | Phase 5 | Pending | +| OUT-01 | Phase 5 | Pending | +| OUT-02 | Phase 5 | Pending | +| OUT-03 | Phase 5 | Pending | +| OUT-04 | Phase 5 | Pending | +| MET-01 | Phase 6 | Pending | +| MET-02 | Phase 6 | Pending | +| MET-03 | Phase 6 | Pending | +| MET-04 | Phase 6 | Pending | +| MET-05 | Phase 6 | Pending | +| PIP-01 | Phase 6 | Pending | +| PIP-02 | Phase 6 | Pending | +| PIP-03 | Phase 6 | Pending | +| PIP-04 | Phase 6 | Pending | **Coverage:** -- v1.1 requirements: 18 total -- Mapped to phases: 18 +- v1.1 requirements: 20 total +- Mapped to phases: 20 - Unmapped: 0 ✓ --- *Requirements defined: 2026-03-16* -*Last updated: 2026-03-16 after initial definition* +*Last updated: 2026-03-16 after roadmap creation* diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..1d60aba --- /dev/null +++ b/.planning/ROADMAP.md @@ -0,0 +1,97 @@ +# 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: +- [x] 01-01: WorkflowStateManager 状态管理 +- [x] 01-02: LinkParser URL 解析 +- [x] 01-03: IdempotencyChecker 幂等检查 + +### Phase 2: Adapters +**Goal**: 平台元数据适配器 +**Plans**: 2 plans + +Plans: +- [x] 02-01: BilibiliAdapter B站适配器 +- [x] 02-02: ZhihuAdapter 知乎适配器 + +### Phase 3: Processors +**Goal**: 管道处理器架构 +**Plans**: 3 plans + +Plans: +- [x] 03-01: BaseProcessor 基类 +- [x] 03-02: 具体处理器实现 +- [x] 03-03: Schema 验证 + +### Phase 4: Pipeline +**Goal**: 处理器编排和 CLI +**Plans**: 2 plans + +Plans: +- [x] 04-01: Pipeline 编排引擎 +- [x] 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/{platform}/{timestamp}_{content_id}_analysis.md` + 4. 用户可通过配置文件自定义中间目录路径 + 5. 归档后可选择性清理中间文件 +**Plans**: TBD + +Plans: +- [ ] 05-01: 中间目录统一和配置 +- [ ] 05-02: ArchiveProcessor 归档处理器 +- [ ] 05-03: 最终目录结构优化 + +#### Phase 6: 代码整合 +**Goal**: 将独立的元数据技能和 Pipeline 模块整合进 kb-workflow +**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 目录已删除 +**Plans**: TBD + +Plans: +- [ ] 06-01: 元数据技能整合 +- [ ] 06-02: Pipeline 模块整合 + +## 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 | 0/3 | Not started | - | +| 6. 代码整合 | v1.1 | 0/2 | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index 59f9724..12a65e7 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -6,9 +6,9 @@ status: planning last_updated: "2026-03-16T00:00:00.000Z" last_activity: 2026-03-16 progress: - total_phases: 0 + total_phases: 2 completed_phases: 0 - total_plans: 0 + total_plans: 5 completed_plans: 0 percent: 0 --- @@ -20,15 +20,36 @@ progress: See: .planning/PROJECT.md (updated 2026-03-16) **Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复 -**Current focus:** v1.1 Architecture Refactor — 定义需求 +**Current focus:** v1.1 Architecture Refactor — Phase 5 归档与目录优化 ## Current Position -**Status:** Defining requirements -**Milestone:** v1.1 Architecture Refactor -**Phase:** Not started +Phase: 5 of 6 (归档与目录优化) +Plan: 0 of 3 in current phase +Status: Ready to plan +Last activity: 2026-03-16 — v1.1 roadmap created -Progress: [░░░░░░░░░░] 0% +Progress: [░░░░░░░░░░] 0% (v1.1 milestone) + +## Performance Metrics + +**Velocity:** +- Total plans completed: 0 (v1.1) +- Average duration: - +- Total execution time: - + +**By Phase:** + +| Phase | Plans | Total | Avg/Plan | +|-------|-------|-------|----------| +| 5. 归档与目录优化 | 0/3 | - | - | +| 6. 代码整合 | 0/2 | - | - | + +**Recent Trend:** +- Last 5 plans: N/A +- Trend: N/A + +*Updated after each plan completion* ## Accumulated Context @@ -41,10 +62,19 @@ Key decisions from v1.0 (preserved): - ✓ 顺序执行 — 简单性和可调试性 - ✓ CLI subparsers — 可扩展命令结构 +v1.1 decisions: +- 中间目录统一到 `~/work/intermediate/analysis/` +- 归档只保留 md 文件，不归档 json 文件 +- 最终目录按平台分组，不再按时间创建子目录 + ### Blockers/Concerns None. ## Session Continuity -**Next step:** Research → Requirements → Roadmap +Last session: 2026-03-16 +Stopped at: Roadmap created for v1.1, ready to plan Phase 5 +Resume file: None + +**Next step:** `/gsd:plan-phase 5`