mirror of
https://github.com/tvytlx/ai-agent-deep-dive.git
synced 2026-04-03 15:44:49 +08:00
98 lines
2.4 KiB
Markdown
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`
|