Files
ai-agent-deep-dive/docs/README.md
2026-04-02 10:09:34 +00:00

98 lines
2.4 KiB
Markdown

# 产品需求文档反推总览
> 目标:基于现有源码结构,反推出这套 AI 编程产品的核心需求与产品设计,而不是复述实现细节。
## 文档原则
- 只写需求、目标、交互、约束、边界条件
- 不直接泄露原始源码实现
- 如需描述机制,只用自然语言或 Python 风格伪代码
- 文档站在产品经理 / 系统设计者视角,回答“为什么需要这个能力”
## 文档结构
1. `00-product-overview.md`
- 产品定位
- 核心用户
- 核心问题
- 顶层系统能力
2. `01-system-prompt-and-orchestration.md`
- 系统提示词层的需求
- 为什么要做动态拼装
- 为什么要做角色化 agent orchestration
3. `02-tools-permissions-and-execution.md`
- 工具系统需求
- 权限系统需求
- Hook / 执行链路 / 安全要求
4. `03-skills-plugins-mcp.md`
- Skills 需求
- Plugins 需求
- MCP 集成需求
5. `04-memory-and-session.md`
- 记忆系统需求
- Session 管理需求
- 压缩、归档、恢复、摘要需求
6. `05-commands-ui-and-operator-experience.md`
- 命令系统需求
- TUI / 状态栏 / 任务可视化需求
- 操作者体验
7. `06-verification-and-quality.md`
- 验证 agent 需求
- 质量保证需求
- 失败报告与可追溯性需求
8. `07-architecture-map.md`
- 按模块汇总产品能力地图
- 用于快速定位需求归属
9. `08-agent-runtime-loop.md`
- 主循环规格
- 多轮执行与终止条件
10. `09-message-model-and-state.md`
- 消息模型
- 会话与状态对象
11. `10-context-management.md`
- 上下文预算
- 压缩与恢复
12. `11-task-model.md`
- 任务模型
- 后台执行与通知
13. `12-workspace-and-isolation.md`
- 工作区隔离策略
- 角色与写权限边界
14. `13-failure-recovery.md`
- 失败处理
- 恢复机制
15. `14-configuration-system.md`
- 配置来源与优先级
- Agent / Session 配置项
16. `15-mvp-scope.md`
- Python MVP 范围
- 哪些先做,哪些后置
17. `16-python-implementation-notes.md`
- Python 版实现建议
- 模块划分与里程碑
## 阅读建议
如果你想快速理解这套产品:
1. 先看 `00-product-overview.md`
2. 再看 `04-memory-and-session.md`
3. 再看 `02-tools-permissions-and-execution.md`
4. 最后看 `03-skills-plugins-mcp.md``06-verification-and-quality.md`