메뉴
交互式首个 REQ 向导，引导新用户在 5 分钟内创建第一个 REQ。自动识别项目类型，推荐模板字段。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
一键将 harness-lab 治理框架接入到当前项目。支持模块选择、冲突检测、PreToolUse hook 配置和 CLI 安装回退。适用于已有项目快速接入治理框架。
创建 bugfix 型 REQ，通过 req:create --type bugfix 自动填充特化内容。
创建 feature 型 REQ，通过 req:create --type feature 自动填充特化内容。
创建 refactor 型 REQ，通过 req:create --type refactor 自动填充特化内容。
为 Claude Code 用户通过 claude --worktree 或手动 git worktree 启动并行 REQ。适用于已有活跃 REQ 时需要另开一条独立工作线。
| name | source-command-first-req |
| description | 交互式首个 REQ 向导，引导新用户在 5 分钟内创建第一个 REQ。自动识别项目类型，推荐模板字段。 |
Use this skill when the user asks to run the migrated source command first-req.
引导新用户快速创建第一个 REQ，降低接入摩擦。
requirements/ 目录存在。不存在 → 提示先运行 /harness-setuppackage.json 中有 req:create 脚本。不存在 → 提示先运行 /harness-setup通过以下信号自动识别项目类型：
| 信号 | 项目类型 |
|---|---|
存在 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 |
使用 AskUserQuestion 工具，提供 3 个推荐选项 + 自定义输入：
推荐选项根据项目类型生成：
根据用户选择的主题，运行：
npm run req:create -- --title "[用户选择的主题]"
创建完成后，自动读取生成的 REQ 文件，填充以下内容：
背景：基于项目类型和主题生成一段简短描述。
目标：根据主题类型推荐 2-3 个目标。
验收标准：根据主题类型推荐 2-3 个可验证的标准。
主题与字段映射：
| 主题类型 | 推荐目标 | 推荐验收标准 |
|---|---|---|
| 组件开发 | 实现组件、编写测试、补充文档 | 组件可渲染、测试通过、Storybook 可用 |
| Bug 修复 | 定位根因、实现修复、回归测试 | Bug 不再复现、回归测试通过 |
| API 开发 | 实现端点、参数校验、错误处理 | API 可调通、4xx/5xx 处理正确 |
| 测试覆盖 | 识别未覆盖路径、编写测试 | 覆盖率提升至目标值 |
| 代码重构 | 消除重复、改善命名、保持行为 | 重构后测试仍通过 |
提示用户确认 REQ 内容是否满意，然后运行：
npm run req:start -- --id [创建的 REQ ID] --phase implementation
向导完成后，输出：
req:create 和 req:start 的验证逻辑req:start 因内容不足被拒绝，提示用户补充后重试