docs: create milestone v1.1 roadmap (2 phases)
This commit is contained in:
+23
-10
@@ -67,21 +67,34 @@ Deferred to future release.
|
|||||||
|
|
||||||
## Traceability
|
## Traceability
|
||||||
|
|
||||||
Updated during roadmap creation.
|
|
||||||
|
|
||||||
| Requirement | Phase | Status |
|
| Requirement | Phase | Status |
|
||||||
|-------------|-------|--------|
|
|-------------|-------|--------|
|
||||||
| INT-01 ~ INT-03 | Phase 5 | Pending |
|
| INT-01 | Phase 5 | Pending |
|
||||||
| ARC-01 ~ ARC-04 | Phase 5 | Pending |
|
| INT-02 | Phase 5 | Pending |
|
||||||
| OUT-01 ~ OUT-04 | Phase 5 | Pending |
|
| INT-03 | Phase 5 | Pending |
|
||||||
| MET-01 ~ MET-05 | Phase 6 | Pending |
|
| ARC-01 | Phase 5 | Pending |
|
||||||
| PIP-01 ~ PIP-04 | Phase 6 | 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:**
|
**Coverage:**
|
||||||
- v1.1 requirements: 18 total
|
- v1.1 requirements: 20 total
|
||||||
- Mapped to phases: 18
|
- Mapped to phases: 20
|
||||||
- Unmapped: 0 ✓
|
- Unmapped: 0 ✓
|
||||||
|
|
||||||
---
|
---
|
||||||
*Requirements defined: 2026-03-16*
|
*Requirements defined: 2026-03-16*
|
||||||
*Last updated: 2026-03-16 after initial definition*
|
*Last updated: 2026-03-16 after roadmap creation*
|
||||||
|
|||||||
@@ -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
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>✅ v1.0 Pipeline Architecture (Phases 1-4) - SHIPPED 2026-03-15</summary>
|
||||||
|
|
||||||
|
### 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 命令
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
### 🚧 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 | - |
|
||||||
+38
-8
@@ -6,9 +6,9 @@ status: planning
|
|||||||
last_updated: "2026-03-16T00:00:00.000Z"
|
last_updated: "2026-03-16T00:00:00.000Z"
|
||||||
last_activity: 2026-03-16
|
last_activity: 2026-03-16
|
||||||
progress:
|
progress:
|
||||||
total_phases: 0
|
total_phases: 2
|
||||||
completed_phases: 0
|
completed_phases: 0
|
||||||
total_plans: 0
|
total_plans: 5
|
||||||
completed_plans: 0
|
completed_plans: 0
|
||||||
percent: 0
|
percent: 0
|
||||||
---
|
---
|
||||||
@@ -20,15 +20,36 @@ progress:
|
|||||||
See: .planning/PROJECT.md (updated 2026-03-16)
|
See: .planning/PROJECT.md (updated 2026-03-16)
|
||||||
|
|
||||||
**Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复
|
**Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复
|
||||||
**Current focus:** v1.1 Architecture Refactor — 定义需求
|
**Current focus:** v1.1 Architecture Refactor — Phase 5 归档与目录优化
|
||||||
|
|
||||||
## Current Position
|
## Current Position
|
||||||
|
|
||||||
**Status:** Defining requirements
|
Phase: 5 of 6 (归档与目录优化)
|
||||||
**Milestone:** v1.1 Architecture Refactor
|
Plan: 0 of 3 in current phase
|
||||||
**Phase:** Not started
|
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
|
## Accumulated Context
|
||||||
|
|
||||||
@@ -41,10 +62,19 @@ Key decisions from v1.0 (preserved):
|
|||||||
- ✓ 顺序执行 — 简单性和可调试性
|
- ✓ 顺序执行 — 简单性和可调试性
|
||||||
- ✓ CLI subparsers — 可扩展命令结构
|
- ✓ CLI subparsers — 可扩展命令结构
|
||||||
|
|
||||||
|
v1.1 decisions:
|
||||||
|
- 中间目录统一到 `~/work/intermediate/analysis/`
|
||||||
|
- 归档只保留 md 文件,不归档 json 文件
|
||||||
|
- 最终目录按平台分组,不再按时间创建子目录
|
||||||
|
|
||||||
### Blockers/Concerns
|
### Blockers/Concerns
|
||||||
|
|
||||||
None.
|
None.
|
||||||
|
|
||||||
## Session Continuity
|
## 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`
|
||||||
|
|||||||
Reference in New Issue
Block a user