From 643acbf16534b02ed3c19727f37b60f580b9b554 Mon Sep 17 00:00:00 2001 From: starmen1265 Date: Mon, 16 Mar 2026 20:54:53 +0800 Subject: [PATCH] docs: start milestone v1.1 Architecture Refactor --- .planning/PROJECT.md | 22 ++++++++++++++++++- .planning/STATE.md | 52 +++++++++++++++----------------------------- 2 files changed, 39 insertions(+), 35 deletions(-) diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 2710d22..a056896 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -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* diff --git a/.planning/STATE.md b/.planning/STATE.md index ea619dd..59f9724 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -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