名称： confirm-form
描述： 生成结构化的确认表单，用于收集用户对多个问题的反馈。适用于需要用户审核的工作完成时、多个问题需要批量确认时，或用户需要在详细上下文中进行多选时。触发场景包括：审核、确认、批量问题、多项选择、需要用户对多个事项提供输入。

确认表单

生成用于结构化用户确认的 HTML 表单，上传至 GitHub Gist，并解析用户回复。

快速开始

1. 准备问题 JSON

[
  {
    "title": "问题标题",
    "context": "背景：我正在处理什么工作",
    "uncertainty": "具体有哪些点我无法独自决定",
    "findings": [
      { "content": "发现 1", "source": "来源 A" },
      { "content": "发现 2", "source": "来源 B" }
    ],
    "judgment": "我的建议及理由",
    "options": [
      { "label": "选项 A", "basis": "选择 A 的理由" },
      { "label": "选项 B", "basis": "选择 B 的理由【我的推荐】" },
      { "label": "需要更多信息", "basis": "如果以上选项都不合适" }
    ]
  }
]

2. 生成表单

node scripts/generate.js questions.json

输出包括：
- 本地 HTML 文件
- GitHub Gist URL
- 预览链接 (htmlpreview.github.io)

3. 发送链接给用户

发送预览链接给用户。用户填写表单后，将结果 JSON 复制返回。

4. 解析回复

用户回复结构如下：

{
  "formId": "form-20260130-180000",
  "timestamp": "...",
  "globalFeedback": "all_ok|need_more_info|discuss|null",
  "globalComment": "总体反馈",
  "summary": { "total": 3, "answered": 3, "agreedWithAI": 2 },
  "answers": [
    {
      "question": "问题标题",
      "selectedLabel": "选项 B",
      "customAnswer": "用户自定义输入（如有）",
      "agreedWithMyJudgment": true
    }
  ]
}

问题设计指南

必填字段

• title: 清晰、简洁的问题标题
• options: 至少 2 个选项，每个选项需包含 label

推荐字段

• context: 背景 - 我正在处理什么工作
• uncertainty: 为什么需要提问 - 是什么阻碍了我做决定
• findings: 带来源的证据 - 展示原始文本，而非仅摘要
• judgment: 我的建议及推理过程

选项设计

• 为每个选项添加 basis（理由）
• 在推荐选项的 basis 中标记 【我的推荐】
• 包含“需要更多信息”作为后备选项

质量原则

1. 提供完整上下文 - 展示原始文本，而非仅提取的数字
2. 解释不确定性 - 为什么我无法独自决定？
3. 引用来源 - 每个发现来自哪里？
4. 论证建议 - 为什么我倾向于这个方向？

工作流集成

CC 任务集成

当 CC 完成一个需要用户确认的任务时，请在 CC 提示中包含：

如果有需要主人确认的问题，在任务最后生成 questions.json 文件，格式：
[{"title":"问题","context":"背景","uncertainty":"不确定点","findings":[...],"judgment":"判断","options":[...]}]

CC 完成后，检查是否存在 questions.json 文件，如果存在则生成表单。

回复归档

收到用户回复后，保存到归档目录：

~/clawd/records/confirm-form/YYYY-MM-DD_<formId>.json

归档格式：

{
  "formId": "...",
  "createdAt": "...",
  "respondedAt": "...",
  "questions": [...],
  "response": {...}
}

可用于：回顾过往决策、追踪确认模式。

文件说明

• scripts/generate.js - 表单生成脚本
• assets/template.html - HTML 表单模板（复制粘贴模式）
• assets/template-v2.html - HTML 表单模板（自动通知模式，实验性）
• assets/examples/sample.json - 示例问题集