update
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# 风险评估模板
|
||||
|
||||
本文档提供设计阶段的风险识别和评估框架。
|
||||
|
||||
---
|
||||
|
||||
## 风险类别
|
||||
|
||||
| 类别 | 示例风险 |
|
||||
|------|----------|
|
||||
| 技术风险 | 技术方案未验证、依赖项不稳定、性能瓶颈 |
|
||||
| 范围风险 | 需求蔓延、功能边界模糊、依赖外部系统 |
|
||||
| 资源风险 | 人力不足、时间紧迫、技能缺口 |
|
||||
| 集成风险 | 第三方 API 变更、数据迁移复杂、兼容性问题 |
|
||||
| 安全风险 | 数据泄露、认证漏洞、权限控制缺陷 |
|
||||
|
||||
---
|
||||
|
||||
## 风险评估矩阵
|
||||
|
||||
```
|
||||
影响程度
|
||||
低 中 高
|
||||
┌────────┬────────┬────────┐
|
||||
高 │ 监控 │ 缓解 │ 优先 │
|
||||
发 ├────────┼────────┼────────┤
|
||||
生 中 │ 接受 │ 监控 │ 缓解 │
|
||||
概 ├────────┼────────┼────────┤
|
||||
率 低 │ 接受 │ 接受 │ 监控 │
|
||||
└────────┴────────┴────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 风险记录模板
|
||||
|
||||
在规格文档中记录风险评估:
|
||||
|
||||
```markdown
|
||||
## 风险评估
|
||||
|
||||
| 风险描述 | 类别 | 影响 | 概率 | 缓解策略 |
|
||||
|----------|------|------|------|----------|
|
||||
| [风险] | [类别] | 高/中/低 | 高/中/低 | [应对方案] |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 缓解策略示例
|
||||
|
||||
| 策略类型 | 适用场景 | 示例 |
|
||||
|----------|----------|------|
|
||||
| 技术验证 | 技术方案不确定 | 对不确定的技术方案进行原型验证 |
|
||||
| 增量交付 | 功能复杂度高 | 将大功能拆分为可独立交付的小功能 |
|
||||
| 备选方案 | 关键依赖风险 | 为关键依赖准备替代方案 |
|
||||
| 监控预警 | 运行时风险 | 建立关键指标的监控机制 |
|
||||
@@ -0,0 +1,68 @@
|
||||
# 会话状态文件模板
|
||||
|
||||
本模板用于跟踪多轮对话中的进度,解决注意力丢失问题。
|
||||
|
||||
---
|
||||
|
||||
## 文件路径
|
||||
|
||||
```
|
||||
design/session-state.md
|
||||
```
|
||||
|
||||
所有技能共用同一状态文件,按阶段更新。
|
||||
|
||||
---
|
||||
|
||||
## 模板
|
||||
|
||||
```markdown
|
||||
# 会话状态
|
||||
|
||||
## 基本信息
|
||||
|
||||
- **技能**: [brainstorming / writing-plan / executing-plans]
|
||||
- **主题**: [功能名称或任务描述]
|
||||
- **开始时间**: YYYY-MM-DD HH:mm
|
||||
- **最后更新**: YYYY-MM-DD HH:mm
|
||||
|
||||
## 当前状态
|
||||
|
||||
- **阶段**: [当前阶段名称]
|
||||
- **上一步**: [刚完成的内容]
|
||||
- **下一步**: [待执行的下一步]
|
||||
|
||||
## 已确认内容
|
||||
|
||||
<!-- 记录用户已确认的关键决策和信息 -->
|
||||
|
||||
- YYYY-MM-DD HH:mm-[决策/信息 1]
|
||||
- YYYY-MM-DD HH:mm-[决策/信息 2]
|
||||
|
||||
## 待处理问题
|
||||
|
||||
<!-- 需要向用户询问或解决的问题 -->
|
||||
|
||||
- [ ] [问题 1]
|
||||
- [ ] [问题 2]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 使用规则
|
||||
|
||||
### 创建时机
|
||||
|
||||
技能激活时创建,路径为项目根目录下的 `design/session-state.md`。
|
||||
|
||||
### 更新时机
|
||||
|
||||
每次获得用户确认或完成阶段性成果后更新。
|
||||
|
||||
### 恢复时机
|
||||
|
||||
每轮对话开始时读取,恢复上下文后继续执行。
|
||||
|
||||
### 技能切换时
|
||||
|
||||
技能切换时更新"技能"字段,保留已确认内容,更新当前状态。
|
||||
82
.agents/skills/brainstorming/references/spec-template.md
Normal file
82
.agents/skills/brainstorming/references/spec-template.md
Normal file
@@ -0,0 +1,82 @@
|
||||
# 规格文档模板
|
||||
|
||||
本文档提供设计规格文档的标准结构。
|
||||
|
||||
---
|
||||
|
||||
## 文档路径
|
||||
|
||||
```
|
||||
design/specs/YYYY-MM-DD-<topic>-design.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 模板
|
||||
|
||||
```markdown
|
||||
# [功能名称] 设计规格
|
||||
|
||||
## 概述
|
||||
|
||||
[功能目标和背景,1-2 段]
|
||||
|
||||
## 目标定位
|
||||
|
||||
- **主要用户**:[用户群体]
|
||||
- **使用场景**:[典型使用场景]
|
||||
|
||||
## 约束条件
|
||||
|
||||
- **技术限制**:[技术栈、框架限制]
|
||||
- **时间限制**:[交付时间要求]
|
||||
- **资源限制**:[人力、预算限制]
|
||||
|
||||
## 成功标准
|
||||
|
||||
- [ ] [可验证的交付标准 1]
|
||||
- [ ] [可验证的交付标准 2]
|
||||
|
||||
## 架构设计
|
||||
|
||||
### 系统结构
|
||||
|
||||
[系统整体架构描述]
|
||||
|
||||
### 组件划分
|
||||
|
||||
| 组件 | 职责 | 依赖 |
|
||||
|------|------|------|
|
||||
| [组件名] | [职责描述] | [依赖组件] |
|
||||
|
||||
## 数据流
|
||||
|
||||
[数据如何流转,可用文字或简单图示]
|
||||
|
||||
## 错误处理
|
||||
|
||||
| 错误类型 | 处理方式 |
|
||||
|----------|----------|
|
||||
| [错误类型] | [处理策略] |
|
||||
|
||||
## 测试策略
|
||||
|
||||
- **单元测试**:[测试范围]
|
||||
- **集成测试**:[测试范围]
|
||||
- **验收标准**:[通过条件]
|
||||
|
||||
## 决策记录
|
||||
|
||||
| 决策 | 理由 | 影响 |
|
||||
|------|------|------|
|
||||
| [决策内容] | [为什么] | [影响范围] |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 质量要求
|
||||
|
||||
- 无 TODO、TBD 或占位符
|
||||
- 所有章节内容完整
|
||||
- 成功标准可验证
|
||||
- 决策有明确理由
|
||||
@@ -0,0 +1,59 @@
|
||||
# 技术选型指导
|
||||
|
||||
本文档提供技术选型的评估框架。
|
||||
|
||||
---
|
||||
|
||||
## 评估维度
|
||||
|
||||
| 维度 | 评估问题 |
|
||||
|------|----------|
|
||||
| 团队熟悉度 | 团队是否已有相关经验?学习成本如何? |
|
||||
| 社区生态 | 文档是否完善?遇到问题能否找到解决方案? |
|
||||
| 长期维护 | 项目是否持续维护?向后兼容性如何? |
|
||||
| 性能特性 | 是否满足性能需求?有无已知问题? |
|
||||
| 集成难度 | 与现有系统的兼容性如何?迁移成本多大? |
|
||||
|
||||
---
|
||||
|
||||
## 选型流程
|
||||
|
||||
1. 明确技术约束条件(团队技能、现有技术栈、预算/时间限制)
|
||||
2. 列出候选方案(通常 2-3 个)
|
||||
3. 按评估维度对比分析
|
||||
4. 给出推荐方案及理由
|
||||
5. 在规格文档中记录选型决策
|
||||
|
||||
---
|
||||
|
||||
## 决策记录模板
|
||||
|
||||
```markdown
|
||||
## 技术选型决策
|
||||
|
||||
### 候选方案对比
|
||||
|
||||
| 方案 | 团队熟悉度 | 社区生态 | 长期维护 | 性能特性 | 集成难度 |
|
||||
|------|------------|----------|----------|----------|----------|
|
||||
| 方案A | 高 | 高 | 高 | 中 | 低 |
|
||||
| 方案B | 中 | 高 | 高 | 高 | 中 |
|
||||
|
||||
### 选择理由
|
||||
|
||||
[为什么选择这个方案]
|
||||
|
||||
### 权衡考量
|
||||
|
||||
[牺牲了什么,换取了什么]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见陷阱
|
||||
|
||||
| 陷阱 | 应对策略 |
|
||||
|------|----------|
|
||||
| 追逐流行 | 评估实际需求匹配度 |
|
||||
| 忽视学习成本 | 预留学习缓冲期 |
|
||||
| 缺乏维护支持 | 检查项目活跃度指标 |
|
||||
| 过度设计 | 遵循 YAGNI 原则 |
|
||||
Reference in New Issue
Block a user