1.项目画像
1.1业务目标
1.2用户与使用场景
| 用户/系统角色 | 典型场景 | 期望结果 | 相关入口 |
|---|---|---|---|
| 待 init | |||
1.3已有功能总览
| 功能域 | 已识别能力 | 关键文件/入口 | 成熟度 | 备注 |
|---|---|---|---|---|
| 待 init:按业务功能归纳,不只罗列文件 | ||||
1.4边界与非目标
| 边界类型 | 说明 | 依据 |
|---|---|---|
| 范围内 | 待 init | 代码/文档/配置 |
| 范围外 | 待 init | 代码/文档/配置 |
2.目录与模块
2.1目录树
. ├── src/ # 待 init:核心代码 ├── tests/ # 待 init:测试 └── ...
2.2模块职责
| 模块 | 职责 | 主要文件 | 依赖模块 | 变更注意点 |
|---|---|---|---|---|
| 待 init | ||||
2.3关键入口
| 入口 | 类型 | 调用链摘要 | 用途 |
|---|---|---|---|
| 待 init:CLI、Web 路由、任务、服务启动点等 | |||
3.架构与技术栈
3.1技术栈
| 层次 | 技术/框架 | 版本来源 | 用途 |
|---|---|---|---|
| 待 init:从 package、lockfile、配置、源码推断 | |||
3.2分层架构
| 层级 | 职责 | 代表文件 | 上下游关系 |
|---|---|---|---|
| 待 init | |||
3.3主流程
// init 填写:用伪代码描述最核心请求/命令/任务链路
3.4外部依赖
| 依赖 | 用途 | 配置位置 | 失败影响 |
|---|---|---|---|
| 待 init:数据库、队列、三方 API、文件系统、模型服务等 | |||
4.工程与质量
4.1构建运行
| 命令 | 用途 | 工作目录 | 注意事项 |
|---|---|---|---|
| 待 init:只记录,不自动执行高成本命令 | |||
4.2测试验证
| 验证方式 | 覆盖范围 | 命令/步骤 | 限制 |
|---|---|---|---|
| 待 init | |||
4.3发布部署
| 阶段 | 产物 | 触发方式 | 风险点 |
|---|---|---|---|
| 待 init | |||
5.约束与规范
5.1代码规范
5.2Agent 约束
- 以功能
review.html为人工审核真相源,ai/*.md不得严重偏离。 - 不自动执行高成本/破坏性命令;不自动提交 git,除非用户明确要求。
- 变更前先确认相关模块边界;跨模块影响必须写入功能审核稿。
5.3安全与数据
| 主题 | 规则 | 涉及位置 | 备注 |
|---|---|---|---|
| 待 init:密钥、权限、隐私数据、迁移脚本等 | |||
6.风险与待确认
6.1已知风险
| 风险 | 影响 | 触发条件 | 建议处理 |
|---|---|---|---|
| 待 init | |||
6.2待确认问题
| 编号 | 问题 | 需要谁确认 | 默认假设 |
|---|---|---|---|
| — | |||
7.功能索引
| slug | 标题 | 状态 | 阶段 | 审核稿 | 更新时间 |
|---|---|---|---|---|---|
| — | |||||