| name | source-command-first-req |
| description | 交互式首个 REQ 向导,引导新用户在 5 分钟内创建第一个 REQ。自动识别项目类型,推荐模板字段。 |
source-command-first-req
Use this skill when the user asks to run the migrated source command first-req.
Command Template
/first-req
目标
引导新用户快速创建第一个 REQ,降低接入摩擦。
前置检查
- 确认
requirements/ 目录存在。不存在 → 提示先运行 /harness-setup
- 确认
package.json 中有 req:create 脚本。不存在 → 提示先运行 /harness-setup
执行步骤
Step 1: 项目类型识别
通过以下信号自动识别项目类型:
| 信号 | 项目类型 |
|---|
存在 package.json + react 依赖 | React |
存在 package.json + next 依赖 | Next.js |
存在 package.json + vue 依赖 | Vue |
存在 pyproject.toml 或 setup.py | Python |
存在 go.mod | Go |
存在 Cargo.toml | Rust |
| 以上都不匹配 | Generic |
Step 2: 用 AskUserQuestion 询问 REQ 主题
使用 AskUserQuestion 工具,提供 3 个推荐选项 + 自定义输入:
推荐选项根据项目类型生成:
- React/Next.js 项目:组件开发、状态管理、API 集成
- Python 项目:数据处理、API 开发、测试覆盖
- Go 项目:性能优化、并发处理、API 开发
- Generic:Bug 修复、功能开发、代码重构
Step 3: 创建 REQ
根据用户选择的主题,运行:
npm run req:create -- --title "[用户选择的主题]"
Step 4: 自动填充 REQ 内容
创建完成后,自动读取生成的 REQ 文件,填充以下内容:
背景:基于项目类型和主题生成一段简短描述。
目标:根据主题类型推荐 2-3 个目标。
验收标准:根据主题类型推荐 2-3 个可验证的标准。
主题与字段映射:
| 主题类型 | 推荐目标 | 推荐验收标准 |
|---|
| 组件开发 | 实现组件、编写测试、补充文档 | 组件可渲染、测试通过、Storybook 可用 |
| Bug 修复 | 定位根因、实现修复、回归测试 | Bug 不再复现、回归测试通过 |
| API 开发 | 实现端点、参数校验、错误处理 | API 可调通、4xx/5xx 处理正确 |
| 测试覆盖 | 识别未覆盖路径、编写测试 | 覆盖率提升至目标值 |
| 代码重构 | 消除重复、改善命名、保持行为 | 重构后测试仍通过 |
Step 5: 启动 REQ
提示用户确认 REQ 内容是否满意,然后运行:
npm run req:start -- --id [创建的 REQ ID] --phase implementation
输出
向导完成后,输出:
- 创建的 REQ ID 和文件路径
- REQ 当前状态
- 下一步建议:直接开始实施,或先补充更多细节
约束
- 不跳过
req:create 和 req:start 的验证逻辑
- 不自动填充颗粒度自检(由用户自己判断)
- 如果
req:start 因内容不足被拒绝,提示用户补充后重试
- 整个流程应在 5 分钟内完成(从运行命令到 REQ 进入 in-progress)