Files

74 lines
1.9 KiB
Markdown

# 规划文档导航
## 使用原则
`plans/` 目录保存架构设计、实施计划、专题方案和历史问题分析。
不要把所有 plan 都当成当前权威事实。
当前事实优先级应是:
1. `README.md`
2. `docs/README.md`
3. `docs/openclaw/README.md`
4. `docs/openclaw/openclaw-handoff.md`
5. `docs/openclaw/openclaw-orchestration-flow.md`
6. `TODO.md`
`plans/` 更适合回答:
- 为什么这样设计
- 某个能力是怎么分阶段落地的
- 某次事故当时是怎么分析的
## 当前权威规划
这些文档仍然是当前协作时应优先阅读的规划基线:
- `reader-mcp-architecture-design.md`
- MCP workflow service 的总体架构方向
- `reader-mcp-implementation-plan.md`
- 实施分阶段计划
- `../TODO.md`
- 当前任务状态与落地进展
## 已完成能力的专题方案
这些方案主要用于回看设计取舍,相关能力已经基本落地:
- `freshrss-pipeline-async-job-plan.md`
- 主日报 async job 方案
- `article-summary-async-job-plan.md`
- 单篇总结 async job 方案
- `resume-run-minimal-design.md`
- `resume_run` 最小恢复语义设计
## 仍有参考价值的专题设计
- `keyword-cleanup-artifact-slimming-v1.md`
- `keyword-cleanup-review-suggestions-layer-design.md`
- `article-summary-prompt-independent.md`
- `article-deep-summary-skill.md`
- `docker-deployment-plan.md`
## 历史问题分析
- `issues/2026-04-06-reader-digest-sigterm.md`
- 一次真实运行事故的分析
## 建议阅读顺序
如果是新接手维护:
1. `reader-mcp-architecture-design.md`
2. `reader-mcp-implementation-plan.md`
3. `../TODO.md`
4. `../docs/openclaw/README.md`
5. `../docs/openclaw/openclaw-handoff.md`
如果是在排查某一类能力:
- 主日报启动/轮询:看 `freshrss-pipeline-async-job-plan.md`
- 恢复:看 `resume-run-minimal-design.md`
- 单篇总结:看 `article-summary-async-job-plan.md`
- 历史故障:看 `issues/2026-04-06-reader-digest-sigterm.md`