technical-design-harness

name	technical-design-harness
description	采用「设计-验证」审议框架完成项目技术方案设计。

框架概述

本技能实现一个「设计-验证」审议循环：两个子agent以文件为唯一沟通媒介，交替运行，审议迭代，直至技术方案的所有技术选型和方案决策都已确定。主Agent仅负责编排，禁止读取子Agent产出文件，仅凭返回状态标记路由。

技术方案是衔接架构设计和编码实现的桥梁——比架构设计更具体（落实到库和技术路径级别），但比代码更抽象（不涉及具体实现细节）。框架不预设技术方案应包含哪些具体内容——由设计agent根据用户输入的实际情况自行判断需要明确哪些技术事项。

本技能不绑定任何具体技术栈。设计中涉及的技术选型、库能力、语言特性等，由子agent依据需求中指定的目标技术栈自行查阅确认。

子agent完整指令文档（启动时让agent自行阅读，不要将内容复制到prompt中）：

designer：技术方案设计agent的角色定义、工作流程与输出规范

verifier：技术方案验证agent的审查维度、报告格式与通过/驳回判定标准

调用参数

调用本技能时需提供以下参数：

• workdir（必填）— 工作目录的绝对路径，所有中间文件将直接写入该目录
• requirement（必填）— 完整需求描述，初始化时写入 {workdir}/requirement.md。需求中应明确或包含目标技术栈，供子agent确认技术选型

workdir 命名规范

运行 date +%Y%m%d%H%M 得到 {YYYYMMDDHHMM}。

workdir 应位于工作区的 designs-tech/ 目录下，命名格式为 designs-tech/{YYYYMMDDHHMM}_{简要描述}/，例如 designs-tech/202604041600_gh-pr-technical-design/。

文件约定

中间文件直接写入 {workdir}/ 目录：

文件	维护者
{workdir}/requirement.md	主Agent，初始化时写入
{workdir}/tech_v{N}.md（N 从1开始递增）	designer
{workdir}/review_v{N}.md	verifier

编排流程

收到用户需求后，按以下流程执行。

1. 初始化

• 创建 {workdir}/ 目录（如不存在）
• 将 {requirement} 写入 {workdir}/requirement.md
• 初始化轮次计数器 N = 1

2. 审议循环（最多 5 轮）

每轮依次执行步骤 A → B → C：

步骤 A — 启动技术方案设计agent

使用 Task 工具（subagent_type: "general"）启动，prompt 结构：

请先阅读文件 {this_skill_dir}/designer.md 获取完整工作指令，然后按要求完成以下任务：

任务描述：{workdir}/requirement.md
技术方案输出文件：{workdir}/tech_v{N}.md
{若 N > 1，追加：上一轮审查文件：{workdir}/review_v{N-1}.md}

等待agent返回。agent应仅返回 TECH_DESIGN_WRITTEN:路径 格式的信息。

步骤 B — 启动验证agent

技术方案设计agent完成后，使用 Task 工具（subagent_type: "general"）启动，prompt 结构：

请先阅读文件 {this_skill_dir}/verifier.md 获取完整工作指令，然后按要求完成以下任务：

任务描述：{workdir}/requirement.md
待审查技术方案文件：{workdir}/tech_v{N}.md
审查输出文件：{workdir}/review_v{N}.md

等待agent返回。agent应仅返回 APPROVED:路径 或 REJECTED:路径 格式的信息。

步骤 C — 判断终止

• 返回 APPROVED → 循环结束，进入步骤 3
• 返回 REJECTED → N++，回到步骤 A
• 若 N 已达 5 → 循环结束，进入步骤 3

3. 向用户返回结果

仅返回以下信息：

• 达成一致时：技术方案设计已完成，最终方案：{workdir}/tech_v{N}.md
• 未达成一致时：从最新 {workdir}/review_v{N}.md 中提取分歧点，附上最终技术方案路径和审查路径

不要将技术方案内容或审查内容输出到对话中，仅返回文件路径。