chore: 移除 superpowers 插件,恢复 openspec 工作流
This commit is contained in:
52
openspec/schemas/code-drive/templates/blocker.md
Normal file
52
openspec/schemas/code-drive/templates/blocker.md
Normal file
@@ -0,0 +1,52 @@
|
||||
## 阻塞点
|
||||
|
||||
<!-- 简述阻塞的本质,不是症状而是根因 -->
|
||||
|
||||
## 当前位置
|
||||
|
||||
- 任务编号:
|
||||
- plan.md 阶段:
|
||||
- 相关文件:
|
||||
|
||||
## 已尝试
|
||||
|
||||
<!-- 列出已尝试的方案和失败原因,避免重复尝试 -->
|
||||
|
||||
| 方案 | 失败原因 |
|
||||
| ---- | -------- |
|
||||
| | |
|
||||
|
||||
## 影响范围
|
||||
|
||||
<!-- 阻塞对上下游 artifacts 的系统性影响 -->
|
||||
|
||||
| Artifact | 影响内容 | 影响程度 |
|
||||
| -------- | -------- | -------- |
|
||||
| | | 必须修订 / 可能受影响 / 无影响 |
|
||||
|
||||
## 可选方案
|
||||
|
||||
### 方案 A:<!-- 方案名称 -->
|
||||
|
||||
- 描述:
|
||||
- 需修订:
|
||||
- 优势:
|
||||
- 风险 / 代价:
|
||||
|
||||
### 方案 B:<!-- 方案名称 -->
|
||||
|
||||
- 描述:
|
||||
- 需修订:
|
||||
- 优势:
|
||||
- 风险 / 代价:
|
||||
|
||||
### 方案 C:<!-- 方案名称 -->(可选)
|
||||
|
||||
- 描述:
|
||||
- 需修订:
|
||||
- 优势:
|
||||
- 风险 / 代价:
|
||||
|
||||
## 修订建议
|
||||
|
||||
<!-- 推荐方案及修订路径:从哪个 artifact 入口开始修订,下游需要同步哪些 -->
|
||||
76
openspec/schemas/code-drive/templates/design.md
Normal file
76
openspec/schemas/code-drive/templates/design.md
Normal file
@@ -0,0 +1,76 @@
|
||||
## 代码库探索
|
||||
|
||||
<!-- 记录 requirements.md 未覆盖的技术探索发现,作为后续设计的依据。如果 requirements.md 中已有充分的探索结果,在此引用并仅补充缺失部分。 -->
|
||||
|
||||
### 已有代码与模式
|
||||
|
||||
<!-- 记录与本次变更相关的现有代码、组件、工具函数、架构模式;requirements.md 已覆盖则写“见 requirements.md”;无相关现有代码则写“无” -->
|
||||
|
||||
### 依赖状态
|
||||
|
||||
<!-- 记录相关依赖的安装状态、版本约束;requirements.md 已覆盖则引用;未安装的依赖需标注 -->
|
||||
|
||||
### 开发规范约束
|
||||
|
||||
<!-- 记录项目规范、代码风格、命名约定、架构模式等对设计的约束;无特殊约束则写“无” -->
|
||||
|
||||
## 整体方案
|
||||
|
||||
### 架构概览
|
||||
|
||||
<!-- 描述本次变更涉及的模块、组件或流程如何组织和协作,用概要方式说明为什么该方案满足 requirements.md -->
|
||||
|
||||
### 关键交互流程
|
||||
|
||||
<!-- 如果变更涉及模块间交互、API 调用、数据流变化或状态转换,在此描述关键路径;无则写“无” -->
|
||||
|
||||
## 目标 / 非目标
|
||||
|
||||
**目标:**
|
||||
<!-- 记录本次技术设计要达成的目标 -->
|
||||
|
||||
**非目标:**
|
||||
<!-- 记录明确不在范围内的内容 -->
|
||||
|
||||
## 关键决策
|
||||
|
||||
<!-- 引用 requirements.md 中已确认的技术决策,仅补充 requirements.md 未覆盖的实现层决策(如具体 API 设计、数据结构、代码组织方式) -->
|
||||
|
||||
| 决策 | 来源 | 理由 |
|
||||
| ---- | ---- | ---- |
|
||||
| <!-- 决策 --> | <!-- requirements.md T1 / 本阶段新增 --> | <!-- 理由或补充说明 --> |
|
||||
|
||||
## 影响范围
|
||||
|
||||
<!-- 记录会受影响的模块、文件、配置、接口、文档、流程或外部依赖 -->
|
||||
|
||||
| 范围 | 变更类型 | 原因 |
|
||||
| ---- | -------- | ---- |
|
||||
| <!-- 范围 --> | <!-- 新增 / 修改 / 删除 / 验证 --> | <!-- 原因 --> |
|
||||
|
||||
### 关键实现路径
|
||||
|
||||
<!-- 按优先级列出 plan.md 应首先处理的核心文件、模块或流程;简单变更可写“同上” -->
|
||||
|
||||
## 依赖与约束
|
||||
|
||||
<!-- 记录依赖限制、兼容性约束、项目规则、质量门禁和禁止事项 -->
|
||||
|
||||
- 依赖:
|
||||
- 兼容性:
|
||||
- 质量门禁:
|
||||
- 禁止事项:
|
||||
|
||||
## 风险 / 权衡
|
||||
|
||||
<!-- 格式:[风险] -> 缓解措施 -->
|
||||
|
||||
## 验证方向
|
||||
|
||||
<!-- 概要说明本次变更应从哪些角度验证,作为 plan.md “验证策略”的输入 -->
|
||||
|
||||
## 待确认事项
|
||||
|
||||
| 状态 | 问题 | 所需决策 |
|
||||
| ---- | ---- | -------- |
|
||||
| 无 | 无待确认事项。 | 无需决策 |
|
||||
114
openspec/schemas/code-drive/templates/plan.md
Normal file
114
openspec/schemas/code-drive/templates/plan.md
Normal file
@@ -0,0 +1,114 @@
|
||||
## 实现概览
|
||||
|
||||
<!-- 概述实现阶段、依赖顺序,以及各阶段如何对应 requirements.md 和 design.md -->
|
||||
|
||||
## 涉及文件
|
||||
|
||||
<!-- 按阶段列出本次变更涉及的核心文件路径,apply 阶段据此定位代码 -->
|
||||
|
||||
| 文件路径 | 变更类型 | 所属阶段 |
|
||||
| -------- | -------- | -------- |
|
||||
| <!-- 文件路径 --> | <!-- 新增 / 修改 / 删除 --> | <!-- 阶段编号 --> |
|
||||
|
||||
## 阶段 1: <!-- 阶段名称 -->
|
||||
|
||||
### 目标
|
||||
|
||||
<!-- 本阶段要完成什么 -->
|
||||
|
||||
### 前置条件
|
||||
|
||||
<!-- 本阶段开始前必须满足什么;没有则写“无” -->
|
||||
|
||||
### 详细实现步骤
|
||||
|
||||
<!-- 写清楚关键文件、函数、数据结构、流程或配置变化。不要使用 checkbox。 -->
|
||||
|
||||
### 关键代码模式
|
||||
|
||||
<!-- 记录本阶段的关键实现细节,apply 据此编写代码。至少覆盖以下内容中适用的部分: -->
|
||||
|
||||
**新增 / 修改的函数或方法:**
|
||||
<!-- 函数签名、参数、返回值、核心逻辑;无则写“无” -->
|
||||
|
||||
**新增 / 修改的数据结构:**
|
||||
<!-- 类型定义、字段、约束;无则写“无” -->
|
||||
|
||||
**调用顺序 / 流程:**
|
||||
<!-- 关键调用链、异步流程、状态转换;无则写“无” -->
|
||||
|
||||
**约定 / 模式:**
|
||||
<!-- 命名规范、错误处理模式、日志规范等;无则写“无” -->
|
||||
|
||||
### 验证方式
|
||||
|
||||
<!-- 本阶段如何独立验证 -->
|
||||
|
||||
### 验收标准
|
||||
|
||||
<!-- 本阶段完成的可验证标准;与 requirements.md 验收标准对齐 -->
|
||||
|
||||
### 关联需求
|
||||
|
||||
<!-- 例如:F1、F2 -->
|
||||
|
||||
## 阶段 2: <!-- 阶段名称 -->
|
||||
|
||||
### 目标
|
||||
|
||||
<!-- 本阶段要完成什么 -->
|
||||
|
||||
### 前置条件
|
||||
|
||||
<!-- 本阶段开始前必须满足什么;没有则写“无” -->
|
||||
|
||||
### 详细实现步骤
|
||||
|
||||
<!-- 写清楚关键文件、函数、数据结构、流程或配置变化。不要使用 checkbox。 -->
|
||||
|
||||
### 关键代码模式
|
||||
|
||||
<!-- 记录本阶段的关键实现细节,apply 据此编写代码。至少覆盖以下内容中适用的部分: -->
|
||||
|
||||
**新增 / 修改的函数或方法:**
|
||||
<!-- 函数签名、参数、返回值、核心逻辑;无则写“无” -->
|
||||
|
||||
**新增 / 修改的数据结构:**
|
||||
<!-- 类型定义、字段、约束;无则写“无” -->
|
||||
|
||||
**调用顺序 / 流程:**
|
||||
<!-- 关键调用链、异步流程、状态转换;无则写“无” -->
|
||||
|
||||
**约定 / 模式:**
|
||||
<!-- 命名规范、错误处理模式、日志规范等;无则写“无” -->
|
||||
|
||||
### 验证方式
|
||||
|
||||
<!-- 本阶段如何独立验证 -->
|
||||
|
||||
### 验收标准
|
||||
|
||||
<!-- 本阶段完成的可验证标准;与 requirements.md 验收标准对齐 -->
|
||||
|
||||
### 关联需求
|
||||
|
||||
<!-- 例如:F1、F2 -->
|
||||
|
||||
## 验证策略
|
||||
|
||||
<!-- 汇总自动化测试、手动检查、文档检查、兼容性检查和验收方式 -->
|
||||
|
||||
## 回退 / 兼容性说明
|
||||
|
||||
<!-- 记录回退策略、错误处理策略、兼容性要求、迁移注意事项;没有则写“无” -->
|
||||
|
||||
- 回退策略:
|
||||
- 错误处理:
|
||||
- 兼容性:
|
||||
- 迁移注意事项:
|
||||
|
||||
## 待确认事项
|
||||
|
||||
| 状态 | 问题 | 所需决策 |
|
||||
| ---- | ---- | -------- |
|
||||
| 无 | 无待确认事项。 | 无需决策 |
|
||||
66
openspec/schemas/code-drive/templates/requirements.md
Normal file
66
openspec/schemas/code-drive/templates/requirements.md
Normal file
@@ -0,0 +1,66 @@
|
||||
## 背景与目标
|
||||
|
||||
<!-- 记录问题、当前状态、相关参考资料,以及触发本次变更的用户请求 -->
|
||||
|
||||
## 讨论记录
|
||||
|
||||
<!-- 记录 explore 或前序讨论中后续 design/plan/apply 必须保留的关键结论 -->
|
||||
|
||||
### 已确认结论
|
||||
|
||||
- <!-- 结论 1 -->
|
||||
- <!-- 结论 2 -->
|
||||
|
||||
### 用户偏好
|
||||
|
||||
- <!-- 偏好 1 -->
|
||||
|
||||
### 被否决方案
|
||||
|
||||
- <!-- 方案及否决原因 -->
|
||||
|
||||
## 功能需求
|
||||
|
||||
<!-- 每条功能需求必须有明确验收标准 -->
|
||||
|
||||
| 编号 | 需求 | 验收标准 |
|
||||
| ---- | ---- | -------- |
|
||||
| F1 | <!-- 需求 --> | <!-- 验收标准 --> |
|
||||
|
||||
## 非功能需求
|
||||
|
||||
<!-- 只记录与本次变更相关的非功能要求 -->
|
||||
|
||||
| 类别 | 要求 |
|
||||
| ---- | ---- |
|
||||
| <!-- 性能 / 兼容性 / 安全 / 可维护性 / 运维 / 文档 --> | <!-- 要求 --> |
|
||||
|
||||
## 技术需求
|
||||
|
||||
<!-- 记录需要确认的技术选型、架构方向、集成边界、代码约束或禁止事项;详细设计属于 design.md -->
|
||||
|
||||
| 编号 | 类别 | 决策 | 理由 | 被否决方案 |
|
||||
| ---- | ---- | ---- | ---- | ---------- |
|
||||
| T1 | <!-- 选型 / 架构 / 约束 / 集成 --> | <!-- 已确认的决策 --> | <!-- 理由 --> | <!-- 被否决方案及原因 --> |
|
||||
|
||||
## 全局审查
|
||||
|
||||
<!-- 从系统边界、既有行为、相邻模块、配置、文档、迁移、兼容性、安全、性能和用户流程角度审查当前需求 -->
|
||||
|
||||
### 与现有系统的关联
|
||||
|
||||
<!-- 记录相关模块、流程、配置、文档、外部接口或用户路径 -->
|
||||
|
||||
### 潜在冲突
|
||||
|
||||
<!-- 记录可能与既有行为、约束、依赖、兼容性或用户预期冲突的点 -->
|
||||
|
||||
### 前置条件
|
||||
|
||||
<!-- 记录执行前必须满足的条件;没有则写“无” -->
|
||||
|
||||
## 开放问题
|
||||
|
||||
| 状态 | 问题 | 所需决策 |
|
||||
| ---- | ---- | -------- |
|
||||
| 无 | 无待解决问题。 | 无需决策 |
|
||||
26
openspec/schemas/code-drive/templates/tasks.md
Normal file
26
openspec/schemas/code-drive/templates/tasks.md
Normal file
@@ -0,0 +1,26 @@
|
||||
## 1. <!-- 对应 plan.md 阶段 1 的名称 -->
|
||||
|
||||
- [ ] 1.1 阅读 plan.md 阶段 1,确认涉及文件、关键代码模式和验收标准
|
||||
- [ ] 1.2 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 1 -->
|
||||
- [ ] 1.3 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 1 -->
|
||||
- [ ] 1.4 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 1 -->
|
||||
- [ ] 1.5 <!-- 运行测试或验证命令,确认阶段 1 的关键行为 -->
|
||||
- [ ] 1.6 按 plan.md 阶段 1 的验收标准确认阶段完成
|
||||
|
||||
## 2. <!-- 对应 plan.md 阶段 2 的名称 -->
|
||||
|
||||
- [ ] 2.1 阅读 plan.md 阶段 2,确认涉及文件、关键代码模式和验收标准
|
||||
- [ ] 2.2 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 2 -->
|
||||
- [ ] 2.3 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 2 -->
|
||||
- [ ] 2.4 <!-- 动词 + 文件路径:具体动作描述,详见 plan.md 阶段 2 -->
|
||||
- [ ] 2.5 <!-- 运行测试或验证命令,确认阶段 2 的关键行为 -->
|
||||
- [ ] 2.6 按 plan.md 阶段 2 的验收标准确认阶段完成
|
||||
|
||||
## 3. 验证与收尾
|
||||
|
||||
- [ ] 3.1 阅读 plan.md 验证策略,确认所有验证项已执行
|
||||
- [ ] 3.2 执行完整测试套件,确认无回归
|
||||
- [ ] 3.3 逐项对照 requirements.md 验收标准,确认全部满足
|
||||
- [ ] 3.4 检查 design.md 关键决策是否被正确实现
|
||||
- [ ] 3.5 如果行为、流程、接口、配置或使用方式发生变化,更新相关文档或交接说明
|
||||
- [ ] 3.6 确认所有任务已标记为 `[x]`,未完成或阻塞事项已记录
|
||||
Reference in New Issue
Block a user