Communitygithub.com

Harness 面试工作流

一个 Codex 技能,能将模糊的任务转化为盲点扫描、面试问题、路径选项和需审批的执行。

Harness 面试工作流 是什么?

该技能专为 AI 编程助手(如 Codex)设计,旨在解决“慢下来”的需求。当一个任务描述模糊或过于复杂时,此技能会启动一个结构化面试流程。它首先执行盲点扫描,分类未知信息,然后有策略地提出 1-3 个关键问题——优先询问那些能改变架构、风险或验证方式的问题。在收集足够上下文后,它会提供 2-3 种清晰的执行路径选项(如最小可行版、稳妥完整版),并等待用户明确确认后才开始执行。执行阶段会创建结构化的工作流工件(如 plan.md),并记录所有实施过程中的决策和偏差。此技能非常适用于需要谨慎规划、分步验证和明确用户授权的复杂项目,可有效避免 AI 直接执行带来的风险。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add 2023Anita/harness-interview-workflow

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Harness 面试工作流 是做什么的?

概述

使用此技能让 Codex 在执行昂贵操作前慢下来。该技能将模糊或复杂的请求转变为结构化的面试:发现未知信息,只询问最高杠杆率的问题,提出路径方案,并在执行前等待明确的批准。

操作契约

  1. 复述用户的目标和可能的交付物。
  2. 在提出执行方案前,先进行盲点扫描。
  3. 每轮最多问 1-3 个问题。
  4. 优先询问那些答案会改变架构、风险、交付物形态或验证方式的问题。
  5. 当拥有足够上下文时,给出 2-3 个路径选项。
  6. 如果用户要求的是计划或尚未批准执行,则在计划后停止。
  7. 如果用户确认执行,则创建正常的实施计划,并对高风险操作使用审批关卡。
  8. 当执行过程中出现边缘情况或偏差时,维护实施笔记。

盲点扫描

将请求归类为四种未知类型:

已知的已知:
已知的未知:
未知的已知:
未知的未知:
最高风险的误解:
最小的下一步行动:

在默认情况下,与 Anita 合作时使用简体中文,除非用户另有要求。

面试模式

只询问接下来的 1-3 个问题。优先按此顺序:

  1. 哪个答案会改变架构或核心路径?
  2. 哪个答案会改变风险边界或审批要求?
  3. 哪个答案会改变最终工件格式?
  4. 哪个答案会改变验证或验收标准?
  5. 哪个答案只影响风格?

避免冗长。如果一个问题可选,则采用保守假设继续并标注该假设。

引用处理

当用户提供文章、仓库、截图、代码、旧项目、模板或示例时,在使用前先对引用进行分类:

  • must reuse:必须保留结构、语义、名称或内容。
  • style reference:借鉴感觉或模式,不要复制。
  • do not imitate:仅用于理解约束条件。
  • fact source:在必要时引用或保留事实来源。

如果分类不明确,则问一个简短的澄清问题。

路径提案

在拥有足够上下文后,提供如下选项:

方案 A:最小可行版
适合:
会做:
不会做:
风险:
验证:

方案 B:稳妥完整版
适合:
会做:
不会做:
风险:
验证:

方案 C:高质量扩展版(可选)
适合:
会做:
不会做:
风险:
验证:

推荐:
等待用户确认:

在用户选择路径或给出明确的确认(如 确认执行、继续 或 按推荐方案执行)之前,不要执行。

批准后的执行

当用户确认执行后,使用此计划形状:

目标:
成功标准:
当前上下文:
约束条件:
风险:
需要审批:
工作流工件路径:
工作包:
集成策略:
验证:
可复用工件:

对于复杂或可重复使用的工作,创建工作流工件:

.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md

如果 codex-dynamic-workflows 可用且工作范围广泛,则与此技能结合使用。

实施笔记

对于执行任务,将笔记保留在任务的自然位置,通常是 implementation-notes.md 或 .workflow/<slug>/results/implementation-notes.md:

# 实施笔记

## 原始计划
## 决策
## 偏差
## 边缘情况
## 用户确认
## 验证
## 后续

当边缘情况导致偏差时,选择保守路径,记录原因,并且仅当仍在用户批准的边界内时才继续执行。

最终回复

对于仅提供计划的工作,返回:

  • 盲点扫描摘要
  • 已问问题或已做假设
  • 路径选项
  • 推荐路径
  • 明确的审批问题

对于已执行的工作,返回:

  • 完成的工件及其路径
  • 验证证据
  • 跳过的检查
  • 剩余风险
  • 如何复用该工作流

对于复杂变更,添加一个简短的事后问答,以便用户确认他们理解已发生的变化。

相关技能