Harness Ops

Harness Ops 是一个在 VS Code 内组织 AI 开发流程的插件。它把需求拆成用户故事，再结合项目约束、设计上下文和运行状态，驱动 Copilot 按步骤执行，减少长会话漂移和无约束改动。

快速开始

第一步先按 Alt+R。

这个快捷键会打开或关闭 Harness Ops 侧边栏。侧边栏里集中放了常用入口，你可以直接从这里开始整个流程。

推荐的使用顺序：

1. 生成需求文档使用<追加需求>继续补充用户故事
2. 初始化项目约束
3. 界面设计描述可选
4. 配置运行时检查可配置检查项开关和重构评分力度
5. 开始执行 当前需求文档执行完成后，可运行归档留存，然后开始下一轮迭代目标的需求文档生成

插件工作流程

Harness Ops 的流程可以理解为 4 步：

1. 先整理需求 使用“生成需求文档”或“追加需求”，把需求整理成 prd.json 中的一组可执行故事。

2. 再补齐上下文 使用“初始化项目约束”和“界面设计描述”，把仓库规则、设计意图和执行边界准备好。

3. 然后开始执行 使用“开始执行”后，插件会按故事顺序驱动 Copilot 执行，并结合已有上下文持续推进。

4. 最后查看结果 你可以通过侧边栏和状态相关命令查看当前进度、失败故事和待审批项。

主要能力

• 用 prd.json 管理需求和故事顺序
• 把项目约束注入执行过程，减少跑偏
• 支持补充界面设计描述，约束 UI 类改动
• 持久化执行状态，便于中断后继续
• 支持失败故事重跑、状态查看和审批处理

常用入口

• Alt+R：打开或关闭 Harness Ops 侧边栏
• HARNESS: 生成需求文档：创建初始需求故事
• HARNESS: 追加需求：在现有 PRD 上继续补充范围
• HARNESS: 初始化项目约束：扫描仓库并生成约束信息
• HARNESS: 界面设计描述：补充页面或模块设计上下文
• HARNESS: 开始执行：按故事顺序启动执行流程
• HARNESS: 查看状态：查看当前执行进度
• HARNESS: 审批故事：处理需要人工确认的故事

运行要求

• VS Code 1.109.0 及以上
• 已安装并启用 GitHub Copilot
• 工作区根目录存在 prd.json，或先通过“生成需求文档”创建