需求文档skill回溯专家博弈之前
This commit is contained in:
闫旭隆
@ -0,0 +1,138 @@
|
||||
# {{PROJECT_NAME}} - 需求文档
|
||||
|
||||
**文档版本**: 1.0
|
||||
**创建时间**: {{CREATED_DATE}}
|
||||
**生成方式**: Claude Code 智能需求生成器
|
||||
**项目类型**: Agent 开发
|
||||
|
||||
---
|
||||
|
||||
## 1. 背景与目标
|
||||
|
||||
### 1.1 项目背景
|
||||
{{BACKGROUND}}
|
||||
|
||||
### 1.2 目标与价值
|
||||
{{OBJECTIVES_AND_VALUE}}
|
||||
|
||||
---
|
||||
|
||||
## 2. 使用场景与触发方式
|
||||
|
||||
### 2.1 典型使用场景
|
||||
{{SCENARIOS}}
|
||||
|
||||
### 2.2 使用入口与触发方式
|
||||
{{ENTRY_METHODS}}
|
||||
|
||||
---
|
||||
|
||||
## 3. 输入输出定义
|
||||
|
||||
### 3.1 输入
|
||||
{{INPUT_DEFINITION}}
|
||||
|
||||
### 3.2 输出
|
||||
{{OUTPUT_DEFINITION}}
|
||||
|
||||
---
|
||||
|
||||
## 4. 交互流程说明
|
||||
|
||||
### 4.1 典型主流程
|
||||
|
||||
{{MAIN_WORKFLOW}}
|
||||
|
||||
> 建议使用 Mermaid 流程图展示：
|
||||
> ```mermaid
|
||||
> flowchart TD
|
||||
> Start([开始]) --> Step1[步骤1]
|
||||
> Step1 --> Step2[步骤2]
|
||||
> Step2 --> End([结束])
|
||||
> ```
|
||||
|
||||
### 4.2 异常与分支流程
|
||||
|
||||
{{EXCEPTION_AND_BRANCH_FLOWS}}
|
||||
|
||||
---
|
||||
|
||||
## 5. 外部系统与数据依赖
|
||||
|
||||
### 5.1 外部数据源需求
|
||||
{{DATA_ACCESS_REQUIREMENTS}}
|
||||
|
||||
### 5.2 系统集成需求
|
||||
{{SYSTEM_INTEGRATION}}
|
||||
|
||||
### 5.3 数据交互时序
|
||||
{{DATA_FLOW_SEQUENCE}}
|
||||
|
||||
> 建议使用 Mermaid 序列图展示数据在各系统间的流转:
|
||||
> ```mermaid
|
||||
> sequenceDiagram
|
||||
> participant U as 用户
|
||||
> participant A as Agent
|
||||
> participant D as 数据库
|
||||
> participant E as 外部API
|
||||
>
|
||||
> U->>A: 发起请求
|
||||
> A->>D: 查询数据
|
||||
> D-->>A: 返回结果
|
||||
> A->>E: 调用外部服务
|
||||
> E-->>A: 返回响应
|
||||
> A-->>U: 展示最终结果
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 6. 系统模块与Agent角色定义
|
||||
|
||||
### 6.1 Agent列表与核心职能
|
||||
{{ROLE_CORE_FUNCTIONS}}
|
||||
|
||||
### 6.2 Agent能力边界
|
||||
{{CAPABILITY_BOUNDARIES}}
|
||||
|
||||
### 6.3 Agent间协作关系
|
||||
{{AGENT_INTERACTIONS}}
|
||||
|
||||
> 建议使用 Mermaid 图展示 Agent 间的调用关系:
|
||||
> ```mermaid
|
||||
> flowchart LR
|
||||
> Main[主Agent] --> Sub1[子Agent1]
|
||||
> Main --> Sub2[子Agent2]
|
||||
> Sub1 --> Sub3[子Agent3]
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 7. 分阶段交付计划
|
||||
|
||||
{{PHASES}}
|
||||
|
||||
---
|
||||
|
||||
## 8. 技术约束与非功能性需求
|
||||
|
||||
### 8.1 技术约束
|
||||
{{TECH_CONSTRAINTS}}
|
||||
|
||||
### 8.2 性能要求
|
||||
{{PERFORMANCE_REQUIREMENTS}}
|
||||
|
||||
### 8.3 安全要求
|
||||
{{SECURITY_REQUIREMENTS}}
|
||||
|
||||
### 8.4 其他非功能性要求
|
||||
{{OTHER_REQUIREMENTS}}
|
||||
|
||||
---
|
||||
|
||||
## 9. 验收标准
|
||||
|
||||
### 9.1 功能验收标准
|
||||
{{FUNCTIONAL_ACCEPTANCE}}
|
||||
|
||||
### 9.2 非功能验收标准
|
||||
{{NON_FUNCTIONAL_ACCEPTANCE}}
|
||||
@ -0,0 +1,183 @@
|
||||
# {{FEATURE_NAME}} 优化 - 需求文档
|
||||
|
||||
**文档版本**: 1.0
|
||||
**创建时间**: {{CREATED_DATE}}
|
||||
**生成方式**: Claude Code 智能需求生成器
|
||||
**项目类型**: 功能优化/更新
|
||||
|
||||
---
|
||||
|
||||
## 1. 现状分析
|
||||
|
||||
### 1.1 当前问题
|
||||
{{CURRENT_PROBLEMS}}
|
||||
|
||||
### 1.2 问题影响
|
||||
{{PROBLEM_IMPACT}}
|
||||
|
||||
### 1.3 问题根因
|
||||
{{ROOT_CAUSE}}
|
||||
|
||||
---
|
||||
|
||||
## 2. 优化目标
|
||||
|
||||
### 2.1 功能目标
|
||||
{{FUNCTIONAL_GOALS}}
|
||||
|
||||
### 2.2 性能目标
|
||||
{{PERFORMANCE_GOALS}}
|
||||
|
||||
### 2.3 质量目标
|
||||
{{QUALITY_GOALS}}
|
||||
|
||||
### 2.4 优先级
|
||||
{{PRIORITY}}
|
||||
|
||||
---
|
||||
|
||||
## 3. 优化方案概述
|
||||
|
||||
### 3.1 主要优化方向
|
||||
{{OPTIMIZATION_DIRECTIONS}}
|
||||
|
||||
### 3.2 技术方案
|
||||
{{TECHNICAL_SOLUTION}}
|
||||
|
||||
### 3.3 预期效果
|
||||
{{EXPECTED_RESULTS}}
|
||||
|
||||
---
|
||||
|
||||
## 4. 功能变更
|
||||
|
||||
### 4.1 新增功能
|
||||
{{NEW_FEATURES}}
|
||||
|
||||
### 4.2 修改功能
|
||||
{{MODIFIED_FEATURES}}
|
||||
|
||||
### 4.3 废弃功能
|
||||
{{DEPRECATED_FEATURES}}
|
||||
|
||||
---
|
||||
|
||||
## 5. 技术变更方向
|
||||
|
||||
### 5.1 架构调整
|
||||
{{ARCHITECTURE_CHANGES}}
|
||||
> 注：描述架构模式的调整，而非具体技术选型
|
||||
|
||||
### 5.2 技术能力需求变化
|
||||
{{TECHNICAL_CAPABILITY_CHANGES}}
|
||||
|
||||
### 5.3 数据层变更方向
|
||||
{{DATA_LAYER_CHANGES}}
|
||||
> 注：描述数据结构、索引等的变更需求，具体实现待开发团队设计
|
||||
|
||||
### 5.4 API 变更
|
||||
{{API_CHANGES}}
|
||||
> 注：描述接口行为的变更，而非实现细节
|
||||
|
||||
### 5.5 具体技术选型
|
||||
|
||||
⏳ **待开发团队决定**
|
||||
|
||||
建议考虑的因素：
|
||||
- 与现有技术栈的兼容性
|
||||
- 变更的风险和成本
|
||||
- 团队熟悉度
|
||||
- 可维护性
|
||||
|
||||
{{TECH_STACK_CONSIDERATIONS}}
|
||||
|
||||
---
|
||||
|
||||
## 6. 兼容性与迁移
|
||||
|
||||
### 6.1 向后兼容性
|
||||
{{BACKWARD_COMPATIBILITY}}
|
||||
|
||||
### 6.2 数据迁移方案
|
||||
{{DATA_MIGRATION}}
|
||||
|
||||
### 6.3 回滚策略
|
||||
{{ROLLBACK_STRATEGY}}
|
||||
|
||||
---
|
||||
|
||||
## 7. 影响范围
|
||||
|
||||
### 7.1 受影响的模块
|
||||
{{AFFECTED_MODULES}}
|
||||
|
||||
### 7.2 受影响的用户
|
||||
{{AFFECTED_USERS}}
|
||||
|
||||
### 7.3 风险评估
|
||||
{{RISK_ASSESSMENT}}
|
||||
|
||||
---
|
||||
|
||||
## 8. 测试策略
|
||||
|
||||
### 8.1 测试范围
|
||||
{{TEST_SCOPE}}
|
||||
|
||||
### 8.2 测试用例
|
||||
{{TEST_CASES}}
|
||||
|
||||
### 8.3 性能测试
|
||||
{{#if NEEDS_PERFORMANCE_TEST}}
|
||||
{{PERFORMANCE_TEST_PLAN}}
|
||||
{{else}}
|
||||
本次优化无需专门的性能测试。
|
||||
{{/if}}
|
||||
|
||||
---
|
||||
|
||||
## 9. 发布计划
|
||||
|
||||
### 9.1 发布方式
|
||||
{{RELEASE_METHOD}}
|
||||
|
||||
### 9.2 发布步骤
|
||||
{{RELEASE_STEPS}}
|
||||
|
||||
### 9.3 监控指标
|
||||
{{MONITORING_METRICS}}
|
||||
|
||||
---
|
||||
|
||||
## 10. 验收标准
|
||||
|
||||
### 10.1 功能验收
|
||||
{{FUNCTIONAL_ACCEPTANCE}}
|
||||
|
||||
### 10.2 性能验收
|
||||
{{PERFORMANCE_ACCEPTANCE}}
|
||||
|
||||
### 10.3 稳定性验收
|
||||
{{STABILITY_ACCEPTANCE}}
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### A. 相关文档
|
||||
{{RELATED_DOCS}}
|
||||
|
||||
### B. 技术债务
|
||||
{{TECH_DEBT}}
|
||||
|
||||
---
|
||||
|
||||
**技术决策概况**
|
||||
- ✅ 用户明确决策: {{EXPLICIT_COUNT}} 项
|
||||
- 💡 智能推断决策: {{INFERRED_COUNT}} 项
|
||||
- ⏳ 待团队决定: {{PENDING_COUNT}} 项
|
||||
|
||||
**图例说明**：
|
||||
- ✅ = 用户明确要求
|
||||
- 💡 = 根据业务需求智能推断
|
||||
- ⏳ = 待开发团队决定
|
||||
@ -0,0 +1,227 @@
|
||||
# {{TEST_TARGET}} 测试 - 需求文档
|
||||
|
||||
**文档版本**: 1.0
|
||||
**创建时间**: {{CREATED_DATE}}
|
||||
**生成方式**: Claude Code 智能需求生成器
|
||||
**项目类型**: 测试项目
|
||||
|
||||
---
|
||||
|
||||
## 1. 测试概述
|
||||
|
||||
### 1.1 测试对象
|
||||
{{TEST_TARGET}}
|
||||
|
||||
### 1.2 测试背景
|
||||
{{TEST_BACKGROUND}}
|
||||
|
||||
### 1.3 测试目标
|
||||
{{TEST_OBJECTIVES}}
|
||||
|
||||
---
|
||||
|
||||
## 2. 测试类型与范围
|
||||
|
||||
### 2.1 测试类型
|
||||
{{TEST_TYPES}}
|
||||
|
||||
### 2.2 测试范围
|
||||
{{TEST_SCOPE}}
|
||||
|
||||
### 2.3 测试深度
|
||||
{{TEST_DEPTH}}
|
||||
|
||||
### 2.4 排除范围
|
||||
{{OUT_OF_SCOPE}}
|
||||
|
||||
---
|
||||
|
||||
## 3. 测试场景
|
||||
|
||||
### 3.1 正常场景
|
||||
{{NORMAL_SCENARIOS}}
|
||||
|
||||
### 3.2 异常场景
|
||||
{{EXCEPTION_SCENARIOS}}
|
||||
|
||||
### 3.3 边界场景
|
||||
{{BOUNDARY_SCENARIOS}}
|
||||
|
||||
### 3.4 用户故事/测试用例
|
||||
{{TEST_CASES}}
|
||||
|
||||
---
|
||||
|
||||
## 4. 测试数据
|
||||
|
||||
### 4.1 数据来源
|
||||
{{DATA_SOURCE}}
|
||||
|
||||
### 4.2 数据量级
|
||||
{{DATA_VOLUME}}
|
||||
|
||||
### 4.3 数据准备方式
|
||||
{{DATA_PREPARATION}}
|
||||
|
||||
### 4.4 隐私保护要求
|
||||
{{PRIVACY_REQUIREMENTS}}
|
||||
|
||||
---
|
||||
|
||||
## 5. 测试环境
|
||||
|
||||
### 5.1 环境配置
|
||||
{{ENVIRONMENT_CONFIG}}
|
||||
|
||||
### 5.2 依赖服务
|
||||
{{DEPENDENCIES}}
|
||||
|
||||
### 5.3 测试能力需求
|
||||
{{TEST_CAPABILITY_REQUIREMENTS}}
|
||||
> 注：描述需要的测试能力（如自动化测试、性能测试、接口测试等），而非具体工具
|
||||
|
||||
### 5.4 环境准备
|
||||
{{ENVIRONMENT_SETUP}}
|
||||
|
||||
---
|
||||
|
||||
## 6. 测试方式
|
||||
|
||||
### 6.1 自动化策略
|
||||
{{AUTOMATION_STRATEGY}}
|
||||
|
||||
### 6.2 测试技术方向
|
||||
{{TEST_TECHNOLOGY_DIRECTION}}
|
||||
> 注：描述测试技术方向（如单元测试、集成测试、E2E测试等）
|
||||
|
||||
### 6.3 具体测试工具和框架
|
||||
|
||||
⏳ **待开发团队决定**
|
||||
|
||||
建议考虑的因素：
|
||||
- 与现有测试技术栈的兼容性
|
||||
- 团队熟悉度
|
||||
- 自动化程度
|
||||
- CI/CD 集成便利性
|
||||
|
||||
{{TEST_TOOL_CONSIDERATIONS}}
|
||||
|
||||
### 6.4 CI/CD 集成
|
||||
{{CICD_INTEGRATION}}
|
||||
|
||||
### 6.4 测试执行计划
|
||||
{{TEST_EXECUTION_PLAN}}
|
||||
|
||||
---
|
||||
|
||||
## 7. 性能指标
|
||||
|
||||
{{#if HAS_PERFORMANCE_TEST}}
|
||||
### 7.1 响应时间要求
|
||||
{{RESPONSE_TIME}}
|
||||
|
||||
### 7.2 吞吐量要求
|
||||
{{THROUGHPUT}}
|
||||
|
||||
### 7.3 并发要求
|
||||
{{CONCURRENCY}}
|
||||
|
||||
### 7.4 资源限制
|
||||
{{RESOURCE_LIMITS}}
|
||||
|
||||
### 7.5 稳定性要求
|
||||
{{STABILITY_REQUIREMENTS}}
|
||||
{{else}}
|
||||
本测试项目不涉及性能测试。
|
||||
{{/if}}
|
||||
|
||||
---
|
||||
|
||||
## 8. 验收标准
|
||||
|
||||
### 8.1 通过标准
|
||||
{{PASS_CRITERIA}}
|
||||
|
||||
### 8.2 覆盖率要求
|
||||
{{COVERAGE_REQUIREMENTS}}
|
||||
|
||||
### 8.3 缺陷标准
|
||||
{{DEFECT_CRITERIA}}
|
||||
|
||||
### 8.4 性能基线
|
||||
{{#if HAS_PERFORMANCE_TEST}}
|
||||
{{PERFORMANCE_BASELINE}}
|
||||
{{else}}
|
||||
无性能基线要求。
|
||||
{{/if}}
|
||||
|
||||
---
|
||||
|
||||
## 9. 测试计划
|
||||
|
||||
### 9.1 测试阶段
|
||||
{{TEST_PHASES}}
|
||||
|
||||
### 9.2 时间安排
|
||||
{{SCHEDULE}}
|
||||
|
||||
### 9.3 人员分工
|
||||
{{TEAM_ASSIGNMENT}}
|
||||
|
||||
### 9.4 里程碑
|
||||
{{MILESTONES}}
|
||||
|
||||
---
|
||||
|
||||
## 10. 交付物
|
||||
|
||||
### 10.1 测试报告
|
||||
{{TEST_REPORT_REQUIREMENTS}}
|
||||
|
||||
### 10.2 测试用例
|
||||
{{TEST_CASE_DELIVERABLES}}
|
||||
|
||||
### 10.3 自动化脚本
|
||||
{{#if HAS_AUTOMATION}}
|
||||
{{AUTOMATION_DELIVERABLES}}
|
||||
{{else}}
|
||||
本测试为手动测试，无自动化脚本交付。
|
||||
{{/if}}
|
||||
|
||||
### 10.4 缺陷列表
|
||||
{{DEFECT_LIST_FORMAT}}
|
||||
|
||||
---
|
||||
|
||||
## 11. 风险与应对
|
||||
|
||||
### 11.1 测试风险
|
||||
{{TEST_RISKS}}
|
||||
|
||||
### 11.2 应对措施
|
||||
{{MITIGATION_STRATEGIES}}
|
||||
|
||||
---
|
||||
|
||||
## 附录
|
||||
|
||||
### A. 测试用例详细列表
|
||||
{{DETAILED_TEST_CASES}}
|
||||
|
||||
### B. 测试环境清单
|
||||
{{ENVIRONMENT_CHECKLIST}}
|
||||
|
||||
### C. 工具和框架说明
|
||||
{{TOOLS_DOCUMENTATION}}
|
||||
|
||||
---
|
||||
|
||||
**技术决策概况**
|
||||
- ✅ 用户明确决策: {{EXPLICIT_COUNT}} 项
|
||||
- 💡 智能推断决策: {{INFERRED_COUNT}} 项
|
||||
- ⏳ 待团队决定: {{PENDING_COUNT}} 项
|
||||
|
||||
**图例说明**：
|
||||
- ✅ = 用户明确要求
|
||||
- 💡 = 根据业务需求智能推断
|
||||
- ⏳ = 待开发团队决定
|
||||
Reference in New Issue
Block a user