PROJECT REVIEW

项目初始化分析

AI 上下文:ai/context.md · 由 /fw init 生成 · 人工只审本页

1.项目画像
1.1业务目标

init 应说明:项目解决什么问题、核心价值、主要交付对象。

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代码规范
  • 待 init:命名、目录归属、状态管理、错误处理、日志等项目约定。
5.2Agent 约束
  • 以功能 review.html 为人工审核真相源,ai/*.md 不得严重偏离。
  • 不自动执行高成本/破坏性命令;不自动提交 git,除非用户明确要求。
  • 变更前先确认相关模块边界;跨模块影响必须写入功能审核稿。
5.3安全与数据
主题规则涉及位置备注
待 init:密钥、权限、隐私数据、迁移脚本等
6.风险与待确认
6.1已知风险
风险影响触发条件建议处理
待 init
6.2待确认问题
编号问题需要谁确认默认假设
7.功能索引
slug标题状态阶段审核稿更新时间