This repository has been archived on 2026-08-07. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
kb-skills/.planning/debug/resolved/kb-workflow-legacy-code-removal.md
2026-03-16 15:27:57 +08:00

2.7 KiB
Raw Permalink Blame History

status, trigger, created, updated
status trigger created updated
resolved kb-workflow不应该再包含旧流程 2026-03-16T10:00:00+08:00 2026-03-16T11:00:00+08:00

Current Focus

hypothesis: 根本原因已确认 - kb_workflow.py 包含312行冗余的旧流程代码,这些代码已被 kb_pipeline 包完全替代 test: 重构并验证 expecting: 修复后测试通过,AI代理不再看到旧代码 next_action: 等待用户确认

Symptoms

expected: kb-workflow 只保留新的管道架构 (基于 kb_pipeline 包) actual: 实际运行时AI代理仍然有时候会参考旧流程的代码处理 errors: 功能异常 - AI代理可能调用旧流程函数而不是新管道 reproduction: AI代理读取 kb_workflow.py 时看到旧流程函数并使用它们 started: 在 v1.0 里程碑完成后发现,新的管道架构已经存在

Eliminated

Evidence

  • timestamp: 2026-03-16T10:05:00+08:00 checked: kb_workflow.py 文件结构 found: 文件共495行,其中:

    • 第1-312行:旧流程代码(内容类型判断、工具函数、归档函数等)
    • 第314-389行:新的 process_command() 使用 kb_pipeline
    • 第391-495行:CLI入口和参数处理 implication: 约63%的代码是旧流程,可能干扰AI代理
  • timestamp: 2026-03-16T10:08:00+08:00 checked: kb_pipeline 包的导出 found: kb_pipeline 已提供完整替代:

    • LinkParser, ParsedLink - URL解析
    • IdempotencyChecker - 查重
    • PlatformAdapter, BilibiliAdapter, ZhihuAdapter - 平台适配
    • WorkflowStateManager - 状态管理
    • Pipeline - 管道编排 implication: 旧函数已被完全替代
  • timestamp: 2026-03-16T10:25:00+08:00 checked: 旧函数与 kb_pipeline 的对应关系 found: 所有旧函数都有替代实现 implication: 可以安全移除

  • timestamp: 2026-03-16T10:40:00+08:00 checked: 修复后的代码 found: kb_workflow.py 从 495 行减少到 143 行(减少 71%) implication: AI代理现在只能看到管道入口

  • timestamp: 2026-03-16T10:42:00+08:00 checked: 测试验证 found: pytest tests/test_cli/test_process_command.py - 7 tests passed implication: 修复后功能正常

Resolution

root_cause: kb_workflow.py 包含312行已废弃的旧流程代码,这些代码已被 kb_pipeline 包完全替代。AI代理读取文件时会看到这些旧函数并可能错误地使用它们。

fix:

  1. 移除 kb_workflow.py 中所有旧流程代码(is_video_content, check_duplicate, archive_and_git 等)
  2. 只保留 process_command() 和 main() 入口
  3. CLI 只保留 process 子命令
  4. 更新 SKILL.md,移除旧命令示例

verification: 7 个测试全部通过

files_changed:

  • kb-workflow/kb_workflow.py
  • kb-workflow/SKILL.md