feat: 添加 code-drive 自定义 schema 与参考资料重组

- 新增 code-drive schema(5 阶段:requirements -> design -> plan -> tasks -> apply)
- 每阶段含 instruction、self-review、用户确认门和工具集成指引
- apply 支持阻塞回退机制(blocker.md + blocker-revise.md skill)
- apply 支持 subagent 并行执行独立任务
- TodoWrite 职责区分:撰写阶段跟踪文档撰写流程,apply 跟踪执行进度
- 将 OpenSpec 子模块移至 references/,新增 superpowers 和 spec-kit 参考
- 添加项目规范 AGENT.md
This commit is contained in:
2026-06-07 13:35:26 +08:00
parent 42906f1383
commit fe55c532b8
12 changed files with 715 additions and 2 deletions

View File

@@ -0,0 +1,52 @@
## 阻塞点
<!-- 简述阻塞的本质,不是症状而是根因 -->
## 当前位置
- 任务编号:
- plan.md 阶段:
- 相关文件:
## 已尝试
<!-- 列出已尝试的方案和失败原因,避免重复尝试 -->
| 方案 | 失败原因 |
| ---- | -------- |
| | |
## 影响范围
<!-- 阻塞对上下游 artifacts 的系统性影响 -->
| Artifact | 影响内容 | 影响程度 |
| -------- | -------- | -------- |
| | | 必须修订 / 可能受影响 / 无影响 |
## 可选方案
### 方案 A<!-- 方案名称 -->
- 描述:
- 需修订:
- 优势:
- 风险 / 代价:
### 方案 B<!-- 方案名称 -->
- 描述:
- 需修订:
- 优势:
- 风险 / 代价:
### 方案 C<!-- 方案名称 -->(可选)
- 描述:
- 需修订:
- 优势:
- 风险 / 代价:
## 修订建议
<!-- 推荐方案及修订路径:从哪个 artifact 入口开始修订,下游需要同步哪些 -->

View 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 “验证策略”的输入 -->
## 待确认事项
| 状态 | 问题 | 所需决策 |
| ---- | ---- | -------- |
| 无 | 无待确认事项。 | 无需决策 |

View File

@@ -0,0 +1,114 @@
## 实现概览
<!-- 概述实现阶段、依赖顺序,以及各阶段如何对应 requirements.md 和 design.md -->
## 涉及文件
<!-- 按阶段列出本次变更涉及的核心文件路径apply 阶段据此定位代码 -->
| 文件路径 | 变更类型 | 所属阶段 |
| -------- | -------- | -------- |
| <!-- 文件路径 --> | <!-- 新增 / 修改 / 删除 --> | <!-- 阶段编号 --> |
## 阶段 1: <!-- 阶段名称 -->
### 目标
<!-- 本阶段要完成什么 -->
### 前置条件
<!-- 本阶段开始前必须满足什么;没有则写“无” -->
### 详细实现步骤
<!-- 写清楚关键文件、函数、数据结构、流程或配置变化。不要使用 checkbox。 -->
### 关键代码模式
<!-- 记录本阶段的关键实现细节apply 据此编写代码。至少覆盖以下内容中适用的部分: -->
**新增 / 修改的函数或方法:**
<!-- 函数签名、参数、返回值、核心逻辑;无则写“无” -->
**新增 / 修改的数据结构:**
<!-- 类型定义、字段、约束;无则写“无” -->
**调用顺序 / 流程:**
<!-- 关键调用链、异步流程、状态转换;无则写“无” -->
**约定 / 模式:**
<!-- 命名规范、错误处理模式、日志规范等;无则写“无” -->
### 验证方式
<!-- 本阶段如何独立验证 -->
### 验收标准
<!-- 本阶段完成的可验证标准;与 requirements.md 验收标准对齐 -->
### 关联需求
<!-- 例如F1、F2 -->
## 阶段 2: <!-- 阶段名称 -->
### 目标
<!-- 本阶段要完成什么 -->
### 前置条件
<!-- 本阶段开始前必须满足什么;没有则写“无” -->
### 详细实现步骤
<!-- 写清楚关键文件、函数、数据结构、流程或配置变化。不要使用 checkbox。 -->
### 关键代码模式
<!-- 记录本阶段的关键实现细节apply 据此编写代码。至少覆盖以下内容中适用的部分: -->
**新增 / 修改的函数或方法:**
<!-- 函数签名、参数、返回值、核心逻辑;无则写“无” -->
**新增 / 修改的数据结构:**
<!-- 类型定义、字段、约束;无则写“无” -->
**调用顺序 / 流程:**
<!-- 关键调用链、异步流程、状态转换;无则写“无” -->
**约定 / 模式:**
<!-- 命名规范、错误处理模式、日志规范等;无则写“无” -->
### 验证方式
<!-- 本阶段如何独立验证 -->
### 验收标准
<!-- 本阶段完成的可验证标准;与 requirements.md 验收标准对齐 -->
### 关联需求
<!-- 例如F1、F2 -->
## 验证策略
<!-- 汇总自动化测试、手动检查、文档检查、兼容性检查和验收方式 -->
## 回退 / 兼容性说明
<!-- 记录回退策略、错误处理策略、兼容性要求、迁移注意事项;没有则写“无” -->
- 回退策略:
- 错误处理:
- 兼容性:
- 迁移注意事项:
## 待确认事项
| 状态 | 问题 | 所需决策 |
| ---- | ---- | -------- |
| 无 | 无待确认事项。 | 无需决策 |

View File

@@ -0,0 +1,66 @@
## 背景与目标
<!-- 记录问题、当前状态、相关参考资料,以及触发本次变更的用户请求 -->
## 讨论记录
<!-- 记录 explore 或前序讨论中后续 design/plan/apply 必须保留的关键结论 -->
### 已确认结论
- <!-- 结论 1 -->
- <!-- 结论 2 -->
### 用户偏好
- <!-- 偏好 1 -->
### 被否决方案
- <!-- 方案及否决原因 -->
## 功能需求
<!-- 每条功能需求必须有明确验收标准 -->
| 编号 | 需求 | 验收标准 |
| ---- | ---- | -------- |
| F1 | <!-- 需求 --> | <!-- 验收标准 --> |
## 非功能需求
<!-- 只记录与本次变更相关的非功能要求 -->
| 类别 | 要求 |
| ---- | ---- |
| <!-- 性能 / 兼容性 / 安全 / 可维护性 / 运维 / 文档 --> | <!-- 要求 --> |
## 技术需求
<!-- 记录需要确认的技术选型、架构方向、集成边界、代码约束或禁止事项;详细设计属于 design.md -->
| 编号 | 类别 | 决策 | 理由 | 被否决方案 |
| ---- | ---- | ---- | ---- | ---------- |
| T1 | <!-- 选型 / 架构 / 约束 / 集成 --> | <!-- 已确认的决策 --> | <!-- 理由 --> | <!-- 被否决方案及原因 --> |
## 全局审查
<!-- 从系统边界、既有行为、相邻模块、配置、文档、迁移、兼容性、安全、性能和用户流程角度审查当前需求 -->
### 与现有系统的关联
<!-- 记录相关模块、流程、配置、文档、外部接口或用户路径 -->
### 潜在冲突
<!-- 记录可能与既有行为、约束、依赖、兼容性或用户预期冲突的点 -->
### 前置条件
<!-- 记录执行前必须满足的条件;没有则写“无” -->
## 开放问题
| 状态 | 问题 | 所需决策 |
| ---- | ---- | -------- |
| 无 | 无待解决问题。 | 无需决策 |

View 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]`,未完成或阻塞事项已记录