kb-skills/.planning/article-analysis-plan.md

kb-deep-analyzer 文章支持 - Implementation Plan

Goal: 让 kb-deep-analyzer 对文章内容生成 300 字摘要 + 原文 + 元数据，而非视频的时间轴分析 Approach: 在 deep_analyzer.py 中根据 --type 参数选择不同的 prompt 模板 Estimated Total Time: 30 分钟

Checkpoint 1: 修改 deep_analyzer.py 核心逻辑 (~15 min)

• Task 1.1: 修改 _build_prompt 方法签名，添加 content_type 参数 (~2 min)

  • Action: 在方法签名中添加 content_type: str = "video"
  • Verify: 方法签名正确

• Task 1.2: 提取视频 prompt 为 _build_video_prompt 方法 (~3 min)

  • Action: 将现有逻辑移到独立方法
  • Verify: 原有视频分析功能不受影响

• Task 1.3: 新增 _build_article_prompt 方法 (~5 min)

  • Action: 创建文章专用 prompt：
    • 300 字以内摘要，描述核心观点
    • 主要主题（不超过 5 个）
    • 标签（3-5 个）
    • 不包含时间轴
  • Verify: prompt 模板符合需求

• Task 1.4: 修改 _build_prompt 根据 content_type 分发 (~2 min)

  • Action:

    if content_type == "article":
        return self._build_article_prompt(...)
    else:
        return self._build_video_prompt(...)
    

  • Verify: 类型判断正确

• Task 1.5: 修改 analyze 方法，传递 content_type (~2 min)

  • Action: 将 content_type 传递到 _build_prompt
  • Verify: 调用链正确

• Task 1.6: 修改 main 函数，传递 type 参数 (~1 min)

  • Action: analyzer.analyze(metadata, content, args.type)
  • Verify: 命令行参数正确传递

Checkpoint 2: 修改输出格式逻辑 (~5 min)

• Task 2.1: 文章输出时保留原文 (~3 min)

  • Action: 在文章类型分析完成后，追加原文内容
  • 格式:

    ## 摘要
    [AI 生成的 300 字摘要]
    
    ## 主要主题
    - 主题1
    - 主题2
    
    ## 原文
    [完整的文章原文]
    

  • Verify: 输出格式正确

• Task 2.2: 调整 frontmatter 生成逻辑 (~2 min)

  • Action: 文章类型不包含 duration 字段
  • Verify: frontmatter 格式正确

Checkpoint 3: 更新文档 (~5 min)

• Task 3.1: 更新 kb-deep-analyzer/SKILL.md (~3 min)

  • Action: 添加 --type article 的使用说明
  • Verify: 文档清晰

• Task 3.2: 确认 kb-workflow/SKILL.md 已正确传递 type 参数 (~2 min)

  • Action: 检查步骤 6 的命令是否包含 --type 参数
  • Verify: workflow 文档正确

Checkpoint 4: 测试验证 (~5 min)

• Task 4.1: 单元测试 - 视频类型不受影响 (~2 min)

  • Action: 确认 --type video 行为不变
  • Verify: 无回归

• Task 4.2: 集成测试 - 文章类型输出正确 (~3 min)

  • Action: 用一篇知乎文章测试 --type article
  • Verify: 输出包含摘要 + 原文，无时间轴

Verification Criteria

• python deep_analyzer.py --type video 行为与之前一致
• python deep_analyzer.py --type article 生成 300 字摘要 + 原文
• 文章输出无"时间轴"部分
• frontmatter 正确（文章无 duration）
• SKILL.md 文档已更新

Execution Options

1. Single-Agent (this session) - 我在本会话中顺序执行任务，每个 checkpoint 汇报

2. Dispatch Sub-Agent - 启动子代理执行开发任务

选择哪种方式？