## 11 两周项目接管计划（LLM辅助）

目标：在 10–14 天内完成从熟悉 → 改动 → 发布 的最小闭环，建立稳定的日常协作节奏与质量门槛。

### A. 里程碑与交付物

- M1（D1–D3）：跑通 CLI/MCP、理解调用链路、提交一份架构要点与问题清单
- M2（D4–D7）：完成一个低风险改进 PR（含测试与文档），建立本地质量流水线
- M3（D8–D11）：完成一项“可见价值”的功能增强（如表格字段增强/查询扩展/错误信息优化）
- M4（D12–D14）：完成一次小型发布（或内部版本），将训练文档与提示词库补齐

### B. 日程建议（可前后微调）

- D1：环境/依赖、`examples/` 验证、阅读 `training/01/03` 与 `README_zh.md`
- D2：阅读 `training/02` 与 `cli_main.py`、`cli/commands/*`，画调用链图
- D3：阅读 `core/*`、`languages/*`、`queries/*`，明确数据模型
- D4：搭建质量流水线（black/isort/ruff/mypy/pytest），补一处微改善
- D5：完善测试与文档，提交 PR（T4）
- D6：选定“可见价值”增强点，拆分任务与验收标准
- D7–D9：实现与测试，保持小步提交
- D10–D11：联调与文档完善，准备发布说明
- D12：小型发布/内部版本，同步训练资料
- D13–D14：回顾与计划下一期 Roadmap

### C. LLM 协作协议（每日节奏）

1) 每日开始：
   - 列出当日目标/准出
   - 用 `08_prompt_library.md` 的模板向 LLM 询问“今天的代码阅读与改动计划”
2) 每次改动：
   - 先让 LLM 生成最小编辑清单与影响面评估
   - 应用更改后立即跑质量流水线（`06_quality_workflow.md`）
3) 每日结束：
   - 产出可验证工件（截图、日志、PR 链接）
   - 更新 `09_tasks.md` 的完成记录

### D. 风险与回避

- 变更公共数据结构要慎重（影响 CLI/MCP/格式化/测试）
- 未经登记的异常类型变更会导致测试集体失败
- 新插件需严格遵循 entry point 与类型注解规范

### E. 度量与可视化

- 通过率：pytest 全绿
- 类型：mypy 严格零错误
- 规范：ruff 0 错 + black/isort 通过
- 覆盖率：新增代码 ≥ 90%
- 文档：对外/对内文档更新到位（README_zh + training）




