docs: start milestone v1.1 Architecture Refactor

This commit is contained in:
2026-03-16 20:54:53 +08:00
parent f358c52578
commit 643acbf165
2 changed files with 39 additions and 35 deletions
+21 -1
View File
@@ -1,5 +1,16 @@
# kb-skills 工作流重构
## Current Milestone: v1.1 Architecture Refactor
**Goal:** 简化代码结构和优化文件组织 — 统一中间目录、添加归档步骤、整合元数据技能和 Pipeline 模块
**Target features:**
- 中间目录统一到 `~/work/intermediate/analysis/`
- 分析完成后自动归档到最终目录
- 最终目录按平台分目录,文件前缀加时间戳
- kb-bilibili-metadata + kb-zhihu-metadata 整合进 kb-workflow
- kb-pipeline 合并进 kb-workflow
## What This Is
一个基于管道模型的知识库内容处理技能体系。将外部链接(B站视频/专栏、知乎问答/专栏)转换为结构化的深度分析报告,支持幂等执行和断点续传。
@@ -45,6 +56,15 @@ python3 kb-workflow/kb_workflow.py process "https://www.bilibili.com/video/BVxxx
### Active
**v1.1 Architecture Refactor:**
- [ ] **REF-01**: 中间目录调整 — 统一到 `~/work/intermediate/analysis/`
- [ ] **REF-02**: 归档步骤 — 分析完成后自动归档到最终目录
- [ ] **REF-03**: 最终目录结构 — 按平台分目录,文件前缀加时间戳
- [ ] **REF-04**: 元数据技能整合 — kb-bilibili-metadata + kb-zhihu-metadata → kb-workflow
- [ ] **REF-05**: Pipeline 整合 — kb-pipeline 合并进 kb-workflow
### Deferred
- [ ] **ADV-01**: 进度可见性 — 实时显示工作流执行进度
- [ ] **ADV-02**: 并行步骤执行 — 支持独立步骤的并行执行
- [ ] **ADV-03**: 说话者分离默认启用 — HF_TOKEN 配置后自动使用
@@ -96,4 +116,4 @@ python3 kb-workflow/kb_workflow.py process "https://www.bilibili.com/video/BVxxx
| 懒加载导入 | AnalyzeProcessor 懒加载 DeepAnalyzer | ✓ Good — 避免依赖问题 |
---
*Last updated: 2026-03-15 after v1.0 milestone*
*Last updated: 2026-03-16 after v1.1 milestone started*
+18 -34
View File
@@ -1,56 +1,40 @@
---
gsd_state_version: 1.0
milestone: v1.0
milestone_name: Pipeline Architecture
status: milestone_complete
last_updated: "2026-03-15T00:00:00.000Z"
last_activity: 2026-03-15
milestone: v1.1
milestone_name: Architecture Refactor
status: planning
last_updated: "2026-03-16T00:00:00.000Z"
last_activity: 2026-03-16
progress:
total_phases: 4
completed_phases: 4
total_plans: 12
completed_plans: 12
percent: 100
total_phases: 0
completed_phases: 0
total_plans: 0
completed_plans: 0
percent: 0
---
# Project State
## Project Reference
See: .planning/PROJECT.md (updated 2026-03-15 after v1.0)
See: .planning/PROJECT.md (updated 2026-03-16)
**Core value:** 可靠、可维护的处理管道 - 每个步骤独立、可验证、可恢复
**Current focus:** Milestone v1.0 complete — ready for v1.1 planning
**Current focus:** v1.1 Architecture Refactor — 定义需求
## Current Position
**Status:** Milestone Complete ✓
**Milestone:** v1.0 Pipeline Architecture
**Shipped:** 2026-03-15
**Status:** Defining requirements
**Milestone:** v1.1 Architecture Refactor
**Phase:** Not started
Progress: [██████████] 100%
## Milestone Summary
| Metric | Value |
|--------|-------|
| Phases | 4 |
| Plans | 12 |
| Timeline | 28 days |
| Files | 243 |
| New LOC | ~50K |
**Key Deliverables:**
- kb_pipeline/ — 核心管道包
- CLI `process` subcommand — 一键式入口
- 完整测试覆盖
Progress: [░░░░░░░░░░] 0%
## Accumulated Context
### Decisions
Key decisions logged in PROJECT.md. Summary:
Key decisions from v1.0 (preserved):
- ✓ 管道模型 — BaseProcessor + Pipeline 架构
- ✓ 步骤级状态 — WorkflowStateManager
- ✓ Schema 验证 — Pydantic v2
@@ -63,4 +47,4 @@ None.
## Session Continuity
**Next step:** `/gsd:new-milestone` — start v1.1 planning
**Next step:** Research → Requirements → Roadmap