first commit

2026-07-25 23:45:09 +08:00
commit c7bd957e6f
47 changed files with 3870 additions and 0 deletions
@@ -0,0 +1,74 @@
+# {{ST编号}} {{子任务名称}}需求分析
+
+## 1. 文档信息与需求来源
+
+- 大需求：{{PM编号及链接}}
+- 子任务编号：{{ST编号}}
+- 原始需求版本：{{版本及链接}}
+- 文档版本：{{版本}}
+- 当前状态：{{状态}}
+- 最后更新：{{时间}}
+
+## 2. 目标、范围与非范围
+
+### 2.1 目标
+
+### 2.2 本次范围
+
+### 2.3 非本次范围
+
+## 3. 业务规则、角色和权限
+
+## 4. 业务流程
+
+### 4.1 正常流程
+
+### 4.2 异常流程
+
+### 4.3 状态流转
+
+## 5. 功能点清单
+
+| 功能编号 | 功能名称 | 需求说明 | 验收标准编号 |
+|---|---|---|---|
+| F-001 | {{功能}} | {{说明}} | AC-001 |
+
+## 6. 涉及工程及现有实现
+
+| 工程 | 当前职责 | 现有入口/代码 | 基准 Commit | 与本任务关系 |
+|---|---|---|---|---|
+
+## 7. 复用、新增、修改和迁移分析
+
+| 功能编号 | 分类 | 复用或改造对象 | 说明 |
+|---|---|---|---|
+
+## 8. 接口、数据及上下游影响
+
+## 9. 非功能与上线要求
+
+## 10. 子任务依赖
+
+## 11. 验收标准
+
+| 编号 | 对应功能 | 可观察的完成条件 | 验证方式 |
+|---|---|---|---|
+| AC-001 | F-001 | {{条件}} | {{方式}} |
+
+## 12. 需求矛盾、风险和待确认项
+
+### 12.1 需求矛盾
+
+| 编号 | 描述位置 A | 描述 A | 描述位置 B | 描述 B | 影响范围 | 状态 | 确认结论 |
+|---|---|---|---|---|---|---|---|
+
+### 12.2 风险与待确认项
+
+| 编号 | 类型 | 内容 | 影响 | 状态 | 结论 |
+|---|---|---|---|---|---|
+
+## 13. 关联文档
+
+- [大需求总览]({{链接}})
+- [技术实现方案](./02.技术实现方案.md)
+- [冒烟与逻辑验证](./03.冒烟与逻辑验证.md)
@@ -0,0 +1,123 @@
+# {{ST编号}} {{子任务名称}}技术实现方案
+
+## 目录
+
+> 使用 Markdown 目录或维护章节索引。
+
+## 1. 文档信息、依据和版本
+
+- 大需求：{{PM编号及链接}}
+- 子任务：{{ST编号}}
+- 原始需求版本：{{版本}}
+- 需求分析：[01.需求分析.md](./01.需求分析.md)
+- 方案版本：{{版本}}
+- 方案状态：{{状态}}
+- 代码基线：{{工程、分支、Commit}}
+- 最后更新：{{时间}}
+
+## 2. 目标、范围和验收依据
+
+## 3. 现有实现与复用分析
+
+| 工程 | 模块/符号 | 当前职责 | 复用或改造方式 | 代码证据 |
+|---|---|---|---|---|
+
+## 4. 总体实现方案
+
+### 4.1 总体流程
+
+### 4.2 模块关系
+
+### 4.3 与其他子任务的关系
+
+## 5. 功能点和接口总览
+
+| 功能编号 | 功能名称 | 接口类型 | 接口/方法 | 工程 | 变更类型 | 章节 |
+|---|---|---|---|---|---|---|
+
+## 6. 各功能点实现方案
+
+### 6.1 F-001 {{功能名称}}
+
+#### 6.1.1 目标与依据
+
+#### 6.1.2 涉及工程和模块
+
+#### 6.1.3 现有逻辑及复用
+
+#### 6.1.4 实现范围
+
+#### 6.1.5 正常、异常和边界流程
+
+#### 6.1.6 接口设计
+
+#### 6.1.7 业务规则和校验
+
+#### 6.1.8 数据读写
+
+#### 6.1.9 权限、事务、并发和幂等
+
+#### 6.1.10 缓存、搜索和消息
+
+#### 6.1.11 兼容、测试和风险
+
+> 为每个功能点重复本节。
+
+## 7. 数据模型设计
+
+### 7.1 数据库
+
+| 表/实体 | 字段 | 类型 | 可空 | 默认值 | 索引/约束 | 业务含义 | 变更类型 |
+|---|---|---|---|---|---|---|---|
+
+### 7.2 Redis
+
+| Key | 类型 | Value 结构 | TTL | 数据来源 | 更新/失效策略 |
+|---|---|---|---|---|---|
+
+### 7.3 Elasticsearch
+
+- 索引与 Alias：
+- 文档 ID：
+- Mapping：
+- 文档示例：
+- 同步、重试和 Reindex：
+
+### 7.4 跨存储一致性
+
+## 8. 跨工程改造与依赖顺序
+
+| 工程 | 模块 | 改造内容 | 输入 | 输出 | 依赖 |
+|---|---|---|---|---|---|
+
+## 9. 变更影响与回归范围
+
+### 9.1 影响矩阵
+
+| 影响编号 | 变更项 | 受影响接口/功能 | 工程 | 类型 | 影响说明 | 是否改造 |
+|---|---|---|---|---|---|---|
+
+### 9.2 回归范围
+
+| 回归编号 | 工程 | 接口/功能 | 回归场景 | 原因 | 优先级 |
+|---|---|---|---|---|---|
+
+## 10. 权限、安全、事务、并发和幂等
+
+## 11. 非功能、日志、监控和审计
+
+## 12. 兼容、迁移、发布和回滚
+
+## 13. 测试与验证设计
+
+## 14. 实施步骤
+
+| 顺序 | 工程 | 实施项 | 前置依赖 | 对应功能/验收项 |
+|---|---|---|---|---|
+
+## 15. 方案取舍、风险和待确认项
+
+## 16. 需求追溯
+
+| 需求/功能 | 方案章节 | 工程 | 验收标准 | 验证用例 |
+|---|---|---|---|---|
@@ -0,0 +1,91 @@
+# {{ST编号}} {{子任务名称}}冒烟与逻辑验证
+
+## 1. 文档信息与验证基线
+
+- 大需求编号：{{PM编号}}
+- 子任务编号：{{ST编号}}
+- 需求版本：{{版本}}
+- 技术方案版本：{{版本}}
+- 文档版本：{{版本}}
+- 当前状态：{{状态}}
+
+## 2. 验证目标、范围和非范围
+
+- 核心主流程：{{流程}}
+- 本次功能点：{{功能}}
+- 关键回归：{{回归}}
+- 非本次验证范围：{{非范围}}
+
+## 3. 环境、前置条件和测试数据
+
+- 计划环境：{{环境}}
+- 前置依赖：{{依赖}}
+- 测试数据及脱敏要求：{{数据}}
+
+## 4. 验证计划
+
+> 第 1–4 节在 G2 前完成并确认。
+
+### 4.1 静态检查、构建和自动化测试计划
+
+| 编号 | 检查/测试 | 计划命令或方式 | 预期结果 |
+|---|---|---|---|
+
+### 4.2 冒烟及功能用例
+
+| 编号 | 功能点 | 验证场景 | 前置条件 | 操作步骤 | 预期结果 | 验证类型 |
+|---|---|---|---|---|---|---|
+| TC-001 | F-001 | {{场景}} | {{条件}} | {{步骤}} | {{预期}} | {{接口/自动化/人工}} |
+
+### 4.3 关键影响回归计划
+
+| 回归编号 | 影响编号 | 工程/功能 | 回归场景 | 预期结果 |
+|---|---|---|---|---|
+
+## 5. 实际执行基线
+
+> 第 5–12 节在代码实现和 Review 后填写。
+
+- 实际环境：{{环境}}
+- 工程和分支：{{记录}}
+- Commit 或版本标识：{{记录}}
+- 执行时间：{{时间}}
+
+## 6. 静态检查、构建和自动化测试结果
+
+| 编号 | 实际命令或方式 | 结果 | 证据或说明 |
+|---|---|---|---|
+
+## 7. 冒烟及功能用例结果
+
+| 用例编号 | 实际结果 | 状态 | 脱敏证据 | 执行时间 |
+|---|---|---|---|---|
+
+## 8. 关键回归结果
+
+| 回归编号 | 实际结果 | 状态 | 脱敏证据 |
+|---|---|---|---|
+
+## 9. 接口和数据验证
+
+- 接口：
+- 数据库：
+- Redis：
+- Elasticsearch：
+- 消息及异步任务：
+- 日志和监控：
+
+## 10. 失败、修复和重验
+
+| 编号 | 失败内容 | 原因 | 修复 | 重验结果 |
+|---|---|---|---|---|
+
+## 11. 未执行项、遗留问题和风险
+
+## 12. 验证结论
+
+- 核心主流程是否通过：{{是/否}}
+- 范围内功能是否全部验证：{{是/否}}
+- 是否存在阻断问题：{{是/否}}
+- 未验证项：{{内容}}
+- 是否具备提测条件：{{是/否}}
@@ -0,0 +1,38 @@
+# {{ST编号}} {{子任务名称}}冒烟自测用例
+
+## 1. 文档信息
+
+- 大需求编号：{{PM编号}}
+- 子任务编号：{{ST编号}}
+- 需求版本：{{版本}}
+- 技术方案版本：{{版本}}
+- 提测版本或 Commit：{{Commit}}
+- 测试环境：{{环境}}
+
+## 2. 自测范围
+
+- 核心主流程：{{流程}}
+- 本次功能点：{{功能}}
+- 关键回归：{{回归}}
+- 非本次自测范围：{{非范围}}
+
+## 3. 前置条件和测试数据
+
+## 4. 冒烟自测用例
+
+| 编号 | 功能点 | 验证场景 | 前置条件 | 操作步骤 | 预期结果 | 实际结果 | 状态 | 证据 |
+|---|---|---|---|---|---|---|---|---|
+| TC-001 | F-001 | {{场景}} | {{条件}} | {{步骤}} | {{预期}} | | 未执行 | |
+
+## 5. 功能覆盖检查
+
+| 功能编号 | 功能名称 | 对应用例 | 是否已验证 |
+|---|---|---|---|
+
+## 6. 自测结论
+
+- 核心主流程是否通过：{{是/否/未执行}}
+- 需求功能点是否全部验证：{{是/否}}
+- 是否存在阻断问题：{{是/否}}
+- 未通过或未验证项：{{内容}}
+- 是否具备提测条件：{{是/否}}
@@ -0,0 +1,54 @@
+# {{ST编号}} {{子任务名称}}技术实现记录
+
+## 1. 实现信息
+
+- 需求版本：{{版本}}
+- 技术方案版本：{{版本}}
+- 开发工程：{{工程}}
+- 开发分支：{{记录}}
+- 实现前 Commit：{{记录}}
+- 实现后 Commit：{{记录}}
+- 当前状态：{{状态}}
+
+## 2. 功能实现状态
+
+| 功能编号 | 功能名称 | 涉及工程 | 实现状态 | 方案章节 | 备注 |
+|---|---|---|---|---|---|
+
+## 3. 工程及代码改动
+
+| 工程 | 模块/文件 | 改动内容 | 对应功能 |
+|---|---|---|---|
+
+## 4. 数据模型改动
+
+- 数据库：
+- Redis：
+- Elasticsearch：
+- 数据迁移：
+
+## 5. 接口改动
+
+## 6. 自动化测试改动
+
+## 7. 与技术方案的差异
+
+## 8. 编译和测试结果
+
+| 检查项 | 命令/方式 | 结果 | 说明 |
+|---|---|---|---|
+
+## 9. 项目规范遵循情况
+
+- 已读取项目规范：
+- 参考的同类实现：
+- 执行的格式化或静态检查：
+- 与既有风格的差异及原因：
+
+## 10. 遗留问题及风险
+
+## 11. 敏感信息与 Git 操作确认
+
+- 文档、日志和验证证据是否完成脱敏：{{是/否}}
+- Agent 是否执行过 `git add`、`git commit`、`git push`：否
+- Git 分支、Commit 和差异：{{记录}}
@@ -0,0 +1,52 @@
+# {{ST编号}} {{子任务名称}}代码 Review 报告
+
+## 1. Review 信息
+
+- 需求版本：{{版本}}
+- 技术方案版本：{{版本}}
+- 工程及分支：{{工程/分支}}
+- Review Commit：{{Commit}}
+- Review 范围：{{范围}}
+- 变更清单或差异来源：{{用户提供/本次编辑记录}}
+- Review 时间：{{时间}}
+
+## 2. 需求符合性
+
+| 检查项 | 结论 | 说明 |
+|---|---|---|
+| 需求功能覆盖 | | |
+| 技术方案符合 | | |
+| 影响范围处理 | | |
+| 无范围外实现 | | |
+
+## 3. 项目规范符合性
+
+| 检查项 | 结论 | 说明 |
+|---|---|---|
+| 架构与分层 | | |
+| 命名与代码风格 | | |
+| 异常、日志和错误码 | | |
+| 测试风格 | | |
+
+## 4. 核心架构变化
+
+| 检查项 | 是否变化 | 是否符合方案 | 结论 |
+|---|---|---|---|
+
+## 5. Review 问题
+
+| 编号 | 等级 | 工程及位置 | 问题 | 影响 | 处理状态 |
+|---|---|---|---|---|---|
+
+## 6. 问题修复及复查
+
+| 问题编号 | 修复内容 | 复查结果 | 证据 |
+|---|---|---|---|
+
+## 7. 未确认风险
+
+## 8. Review 结论
+
+- Critical/High 是否清零：{{是/否}}
+- 是否需要重开方案门禁：{{是/否}}
+- 结论：在本次检查范围内{{结论}}
@@ -0,0 +1,55 @@
+# {{ST编号}} {{子任务名称}}逻辑验证报告
+
+## 1. 验证信息
+
+- 需求版本：{{版本}}
+- 技术方案版本：{{版本}}
+- 验证工程和分支：{{工程/分支}}
+- 验证 Commit：{{Commit}}
+- 验证环境：{{环境}}
+- 验证时间：{{时间}}
+
+## 2. 静态检查与构建
+
+| 检查项 | 命令/方式 | 结果 | 证据或说明 |
+|---|---|---|---|
+
+## 3. 自动化测试
+
+| 测试类型 | 测试范围 | 通过 | 失败 | 结果 |
+|---|---|---|---|---|
+
+## 4. 冒烟自测
+
+| 用例编号 | 功能点 | 预期结果 | 实际结果 | 状态 | 证据 |
+|---|---|---|---|---|---|
+
+## 5. 关键回归
+
+| 回归编号 | 场景 | 结果 | 证据 |
+|---|---|---|---|
+
+## 6. 接口与数据验证
+
+- 接口：
+- 数据库：
+- Redis：
+- Elasticsearch：
+- 消息及异步任务：
+- 日志和监控：
+
+## 7. 失败与修复
+
+| 编号 | 失败 | 原因 | 修复 | 重验结果 |
+|---|---|---|---|---|
+
+## 8. 未执行项及原因
+
+## 9. 遗留问题和风险
+
+## 10. 验证结论
+
+- 核心主流程是否通过：{{是/否}}
+- 范围内功能是否全部验证：{{是/否}}
+- 是否存在阻断问题：{{是/否}}
+- 是否具备提测条件：{{是/否}}
@@ -0,0 +1,54 @@
+# {{ST编号}} {{子任务名称}}验收与交付报告
+
+## 1. 交付信息
+
+- 需求版本：{{版本}}
+- 涉及工程：{{工程}}
+- 开发分支：{{分支}}
+- 发布分支或 Tag：{{分支/Tag}}
+- 发布 Commit：{{Commit}}
+- Git 信息来源：{{用户提供的记录}}
+
+## 2. 开发交付内容
+
+## 3. 测试结果
+
+- 测试环境：{{环境}}
+- 测试时间：{{时间}}
+- 测试人员：{{人员}}
+- 测试结论：{{结论}}
+- 缺陷及处理情况：{{内容}}
+- 测试报告：{{链接或编号}}
+
+## 4. 发布记录
+
+- 发布时间：{{时间}}
+- 发布环境：{{环境}}
+- 发布版本：{{版本}}
+- 发布工程：{{工程}}
+- 数据脚本：{{脚本}}
+- 配置变化：{{配置}}
+- 实际发布顺序：{{顺序}}
+
+## 5. 上线验证
+
+| 检查项 | 验证方式 | 结果 | 证据 |
+|---|---|---|---|
+| 核心主流程 | | | |
+| 关键接口 | | | |
+| 数据库 | | | |
+| Redis | | | |
+| Elasticsearch | | | |
+| 消息及任务 | | | |
+| 日志和监控 | | | |
+
+## 6. 遗留问题
+
+## 7. 最终结论
+
+- 是否测试通过：{{是/否}}
+- 是否发布成功：{{是/否}}
+- 是否完成上线验证：{{是/否}}
+- 是否满足归档条件：{{是/否}}
+
+> `git add`、`git commit`、`git push` 由用户执行；报告证据必须脱敏。
@@ -0,0 +1,51 @@
+# {{ST编号}} {{子任务名称}}验收与交付报告
+
+## 1. 交付信息
+
+- 需求版本：{{版本}}
+- 涉及工程：{{工程}}
+- 开发分支：{{分支}}
+- 发布分支或 Tag：{{分支/Tag}}
+- 发布 Commit：{{Commit}}
+
+## 2. 开发交付内容
+
+## 3. 测试结果
+
+- 测试环境：{{环境}}
+- 测试时间：{{时间}}
+- 测试人员：{{人员}}
+- 测试结论：{{结论}}
+- 缺陷及处理情况：{{内容}}
+- 测试报告：{{链接或编号}}
+
+## 4. 发布记录
+
+- 发布时间：{{时间}}
+- 发布环境：{{环境}}
+- 发布版本：{{版本}}
+- 发布工程：{{工程}}
+- 数据脚本：{{脚本}}
+- 配置变化：{{配置}}
+- 实际发布顺序：{{顺序}}
+
+## 5. 上线验证
+
+| 检查项 | 验证方式 | 结果 | 证据 |
+|---|---|---|---|
+| 核心主流程 | | | |
+| 关键接口 | | | |
+| 数据库 | | | |
+| Redis | | | |
+| Elasticsearch | | | |
+| 消息及任务 | | | |
+| 日志和监控 | | | |
+
+## 6. 遗留问题
+
+## 7. 最终结论
+
+- 是否测试通过：{{是/否}}
+- 是否发布成功：{{是/否}}
+- 是否完成上线验证：{{是/否}}
+- 是否满足归档条件：{{是/否}}
@@ -0,0 +1,71 @@
+# {{需求名称}}精简变更日志
+
+## 1. 基本信息
+
+- 需求编号：{{编号}}
+- 影响等级：L1
+- 当前状态：{{状态}}
+- 创建时间：{{时间}}
+- 最后更新：{{时间}}
+
+## 2. 需求说明
+
+{{需求内容及来源}}
+
+## 3. 变更范围
+
+- 涉及工程：{{工程}}
+- 涉及功能：{{功能}}
+- 涉及接口：{{接口}}
+- 非本次范围：{{非范围}}
+
+## 4. 影响及回归范围
+
+| 变更项 | 受影响功能/接口 | 影响说明 | 回归场景 |
+|---|---|---|---|
+
+## 5. 技术实现计划
+
+- 现有逻辑：{{现状}}
+- 复用内容：{{复用}}
+- 计划改动：{{改动}}
+- 数据变化：{{数据}}
+- 风险与待确认项：{{风险}}
+
+## 6. 冒烟自测用例
+
+| 编号 | 功能点 | 验证场景 | 预期结果 |
+|---|---|---|---|
+
+## 7. 用户确认记录
+
+- 确认结论：{{结论}}
+- 确认时间：{{时间}}
+- 确认来源：{{来源}}
+
+## 8. 实际代码改动
+
+| 工程/文件 | 实际改动 | 对应功能 |
+|---|---|---|
+
+## 9. Code Review
+
+| 编号 | 等级 | 问题 | 处理结果 |
+|---|---|---|---|
+
+## 10. 逻辑验证和冒烟结果
+
+| 检查/用例 | 执行方式 | 结果 | 证据 |
+|---|---|---|---|
+
+## 11. 遗留问题
+
+{{遗留问题或“无”}}
+
+## 12. 完成结论
+
+- 是否开发完成：{{是/否}}
+- 是否具备提测条件：{{是/否}}
+- 未验证项：{{内容}}
+- 文档和证据是否完成脱敏：{{是/否}}
+- Agent 是否执行过 `git add`、`git commit`、`git push`：否
@@ -0,0 +1,11 @@
+# 代码分析副本清单
+
+| 工程 | 本地目录 | 远端仓库 | 基准分支 | 当前 Commit | 更新时间 | 备注 |
+|---|---|---|---|---|---|---|
+
+## 异常记录
+
+| 时间 | 工程 | 异常 | 处理状态 |
+|---|---|---|---|
+
+> `code/` 只用于调查；需求开发在独立项目工作区完成。
@@ -0,0 +1,40 @@
+# {{PM编号}} 任务状态
+
+## 1. 大需求状态
+
+- 需求名称：{{名称}}
+- 当前需求版本：{{版本}}
+- 当前总体状态：{{状态}}
+- 当前主要阶段：{{阶段}}
+- 最后更新时间：{{时间}}
+- 当前阻塞项：{{阻塞或“无”}}
+
+## 2. 门禁状态
+
+| 门禁 | 状态 | 原始需求版本 | 确认文档及版本 | 代码版本标识 | 确认时间 | 确认来源 | 确认范围/说明 |
+|---|---|---|---|---|---|---|---|
+| G1 需求门禁 | 待确认 | | | 不适用 | | | |
+| G2 方案门禁 | 未开始 | | | | | | |
+| G3 开发交付门禁 | 未开始 | | | | | | |
+
+## 3. 子任务状态
+
+| 子任务 | 业务模块 | 当前阶段 | 当前状态 | 阻塞项 | 最后更新 |
+|---|---|---|---|---|---|
+
+## 4. 阶段完成情况
+
+| 子任务 | 需求分析 | 技术方案 | 验证计划 | 实现 | Review | 逻辑验证 | 测试 | 上线 |
+|---|---|---|---|---|---|---|---|---|---|
+
+## 5. 阻塞事项
+
+| 编号 | 子任务 | 阻塞内容 | 影响阶段 | 提出时间 | 处理方 | 状态 |
+|---|---|---|---|---|---|---|
+
+## 6. 状态变更历史
+
+| 时间 | 对象 | 原阶段/状态 | 新阶段/状态 | 变更原因 | 操作者 | 证据 |
+|---|---|---|---|---|---|---|
+
+> `STATUS.md` 是状态唯一事实来源。其他文档中的状态字段仅用于展示，发生冲突时以本文件为准。
@@ -0,0 +1,16 @@
+# 原始需求版本索引
+
+| 版本 | 接收时间 | 需求来源 | 文件或目录 | 主要变化 | 状态 |
+|---|---|---|---|---|---|
+| v1 | {{时间}} | {{来源}} | [查看](./v1/) | 初始版本 | 当前版本 |
+
+## 补充需求记录
+
+| 编号 | 时间 | 来源 | 内容 | 是否进入正式版本 |
+|---|---|---|---|---|
+
+## 管理规则
+
+- 原始文件只读，不覆盖旧版本。
+- 每个版本尽量保存完整材料。
+- 新版本到达后进行差异和影响分析。
@@ -0,0 +1,36 @@
+# {{PM编号}} {{需求名称}}
+
+## 1. 基本信息
+
+- 大需求编号：{{PM编号}}
+- 当前需求版本：{{版本}}
+- 当前状态：{{状态}}
+- 创建时间：{{时间}}
+- 最后更新：{{时间}}
+
+## 2. 需求来源
+
+- [原始需求版本索引](./source/README.md)
+- 当前需求版本：{{相对链接}}
+
+## 3. 技术侧需求分析
+
+- [技术侧需求分析](./技术侧需求分析.md)
+
+## 4. 子任务
+
+| 编号 | 业务模块 | 当前阶段 | 当前状态 | 前置依赖 | 需求分析 |
+|---|---|---|---|---|---|
+| ST-001 | {{模块}} | {{阶段}} | {{状态}} | {{依赖}} | [查看](./tasks/ST-001-模块/01.需求分析.md) |
+
+## 5. 代码基线
+
+- [代码副本清单](./code/MANIFEST.md)
+
+## 6. 状态与门禁
+
+- [任务状态](./STATUS.md)
+
+## 7. 归档
+
+测试、上线和上线验证完成后生成 `归档记录.md`，并在此补充链接。
@@ -0,0 +1,72 @@
+# {{PM编号}} {{需求名称}}归档记录
+
+## 1. 基本信息
+
+- 大需求编号：{{PM编号}}
+- 需求名称：{{名称}}
+- 最终需求版本：{{版本}}
+- 需求负责人：{{负责人}}
+- 开发完成时间：{{时间}}
+- 测试通过时间：{{时间}}
+- 上线时间：{{时间}}
+- 归档时间：{{时间}}
+- 最终状态：已归档
+
+## 2. 需求目标与最终范围
+
+- 需求背景：{{背景}}
+- 最终实现范围：{{范围}}
+- 未实现、延期或取消范围：{{内容}}
+- 需求变更摘要：{{摘要}}
+
+## 3. 子任务完成情况
+
+| 子任务 | 业务模块 | 开发状态 | 测试状态 | 上线状态 | 文档 |
+|---|---|---|---|---|---|
+
+## 4. 工程发布信息
+
+| 工程 | 发布分支 | 发布版本/Tag | 上线 Commit | 上线时间 |
+|---|---|---|---|---|
+
+## 5. 数据及配置变更
+
+- 数据库：
+- Redis：
+- Elasticsearch：
+- 配置中心：
+- 数据迁移：
+- 其他：
+
+## 6. 测试和验证结论
+
+- Code Review：
+- 冒烟与逻辑验证：
+- 测试人员测试：
+- 上线验证：
+
+## 7. 关键文档索引
+
+- 原始需求：
+- 技术侧需求分析：
+- 子任务需求分析：
+- 技术实现方案：
+- 冒烟与逻辑验证：
+- Code Review：
+- 验收与交付：
+
+## 8. 遗留问题和已知风险
+
+| 编号 | 问题 | 影响 | 当前处理 | 后续建议 |
+|---|---|---|---|---|
+
+## 9. 后续维护说明
+
+- 可复用能力：
+- 维护注意事项：
+- 后续优化方向：
+- 关联需求：
+
+## 10. 归档结论
+
+{{最终结论}}
@@ -0,0 +1,50 @@
+# {{PM编号}} 技术侧需求分析
+
+## 1. 文档信息
+
+- 需求名称：{{名称}}
+- 当前需求版本：{{版本}}
+- 文档版本：{{版本}}
+- 文档状态：{{状态}}
+- 依据代码版本：[MANIFEST](./code/MANIFEST.md)
+- 最后更新：{{时间}}
+
+## 2. 需求背景与目标
+
+## 3. 技术侧需求解读
+
+## 4. 范围与非范围
+
+### 4.1 本次范围
+
+### 4.2 非本次范围
+
+## 5. 业务模块及子任务拆分
+
+| 子任务 | 业务模块 | 目标 | 依赖 |
+|---|---|---|---|
+
+## 6. 功能迭代清单
+
+### 6.1 新增
+
+### 6.2 修改
+
+### 6.3 复用
+
+### 6.4 废弃或迁移
+
+## 7. 涉及工程
+
+| 工程 | 当前职责 | 涉及功能 | 影响原因 | 预计变更类型 | 证据 |
+|---|---|---|---|---|---|
+
+## 8. 接口、数据及上下游影响
+
+## 9. 非功能需求
+
+## 10. 发布、迁移、兼容和回滚要求
+
+## 11. 依赖、风险和待确认项
+
+## 12. 子任务文档索引
@@ -0,0 +1,21 @@
+# Vibe Coding 模板索引
+
+项目或用户提供的模板优先；没有专用模板时复制以下内置模板。
+
+| 模板 | 用途 | 建议落地文件 |
+|---|---|---|
+| [L1-精简变更日志模板.md](L1-精简变更日志模板.md) | L1 单文档全流程 | `01.精简变更日志.md` |
+| [大需求总览模板.md](大需求总览模板.md) | L2 大需求导航 | `README.md` |
+| [任务状态模板.md](任务状态模板.md) | 当前状态、门禁、阻塞和历史 | `STATUS.md` |
+| [原始需求版本索引模板.md](原始需求版本索引模板.md) | source 版本索引 | `source/README.md` |
+| [代码副本清单模板.md](代码副本清单模板.md) | 分析代码基线 | `code/MANIFEST.md` |
+| [技术侧需求分析模板.md](技术侧需求分析模板.md) | 大需求的研发侧功能解读 | `技术侧需求分析.md` |
+| [01-需求分析模板.md](01-需求分析模板.md) | L2 子任务需求分析 | `01.需求分析.md` |
+| [02-技术实现方案模板.md](02-技术实现方案模板.md) | L2 子任务单文档技术方案 | `02.技术实现方案.md` |
+| [03-冒烟与逻辑验证模板.md](03-冒烟与逻辑验证模板.md) | G2 验证计划和 G3 实际验证结果 | `03.冒烟与逻辑验证.md` |
+| [04-技术实现记录模板.md](04-技术实现记录模板.md) | 实际代码改动记录 | `04.技术实现记录.md` |
+| [05-代码Review报告模板.md](05-代码Review报告模板.md) | 代码审查 | `05.代码Review报告.md` |
+| [06-验收与交付报告模板.md](06-验收与交付报告模板.md) | 测试、上线和交付 | `06.验收与交付报告.md` |
+| [归档记录模板.md](归档记录模板.md) | 大需求逻辑归档 | `归档记录.md` |
+
+复制后删除不适用的示例行，但保留必要章节；不适用的关键章节写明原因。