skill-d-create-issues

Validate issue draft existence and status, batch create Gitea issues with dependencies on confirmation, update meeting status, and manage related email notif...

Skill-D: create_issues — issue 落地总控

定位

本技能是 事件驱动的 issue 落地流程总控。由组织者确认 issue 草稿后触发，非 cron。

职责分工：

• OpenClaw

  • 被 webhook 或对话触发后，调用 check 验证前置条件
  • 读取 confirmed_issue.md 内容，解析出每条 action item 的结构化字段
  • 判断 meeting_category（single / cross-project）
  • 单项目：调用 create-issues 批量建 Gitea issue
  • 调用 finish 收尾，获取邮件参数
  • 调用 imap-smtp-email 发送正式纪要邮件（全员）+ 个人任务通知（各 assignee）
  • 跨项目：调用 finish（跳过建 issue），调用 imap-smtp-email 向组织者发建议邮件

• Skill-D（本技能）

  • check：校验 meta.yaml status 和 confirmed_issue.md 存在性，返回内容与元信息
  • create-issues：接收 OpenClaw 解析好的 JSON，批量在 Gitea 建 issue + 依赖回填
  • finish：meta.yaml → minutes-published，写 created_issues 字段，写日志，返回邮件参数
  • webhook.py：独立常驻进程，监听 Gitea push webhook，检测到 confirmed_issue.md 时向 OpenClaw 发送触发信号

• imap-smtp-email

  • 发送正式纪要邮件（全体参会人）
  • 发送个人任务通知邮件（各 assignee 单独一封）
  • 发送跨项目 issue 建议邮件（组织者）

---

配置要求

配置文件：~/.config/skill-d-create-issues/.env

首次使用前运行：

bash

bash setup.sh

---

触发方式

方式 A：Gitea Webhook（推荐）

组织者在 Gitea 网页将 draft_issue.md 改名为 confirmed_issue.md，触发 push webhook。

Webhook 配置步骤：

1. 在每个受管仓库（包括 aifusion-meta）的 Settings → Webhooks → Add Webhook
2. URL：http://43.156.243.152:<WEBHOOK_PORT>/gitea-webhook（端口见 .env）
3. Content Type：application/json
4. Trigger：Push Events

启动 Webhook 监听服务（后台常驻）：

bash

nohup python3 scripts/webhook.py > ~/.config/skill-d-create-issues/webhook.log 2>&1 &

方式 B：OpenClaw 对话

text

用户："确认 2026-04-22-1500 的 issue"

OpenClaw 识别后，询问用户确认的是哪个仓库（如果上下文不明确），然后进入以下工作流。

---

严格工作流（两种触发方式执行相同流程）

---

第一步：调用 check，验证前置条件

bash

node main.js check \
  --repo "HKU-AIFusion/dexterous-hand" \
  --meeting-dir "2026-04-22-1500"

返回 JSON，关键字段：

• valid：true / false（false 时含 reason 字段，OpenClaw 直接告知用户）
• category：single | cross-project
• topic、organizer、organizer_email、attendees、attendee_emails
• confirmed_issue_content：confirmed_issue.md 的完整文本
• minutes_content：minutes.md 的完整文本（用于正式纪要邮件）
• meeting_dir、repo、join_url

valid 为 false 时，OpenClaw 向用户说明原因，不继续执行后续步骤。

---

第二步：OpenClaw 解析 confirmed_issue.md

此步骤 OpenClaw 作为 AI 负责全部解析，不调用任何脚本。

从 confirmed_issue_content 中解析每条带勾选框的 action item，输出 JSON 数组，只输出 JSON，不加任何说明文字或 markdown 标记：

json

[
  {
    "local_id": "1",
    "task": "任务描述",
    "assignee": "sujinze",
    "due_date": "2026-04-29",
    "depends_on_local_ids": [],
    "quote": "原话引用"
  },
  {
    "local_id": "2",
    "task": "另一个任务",
    "assignee": "liuzhaolin",
    "due_date": "2026-05-06",
    "depends_on_local_ids": ["1"],
    "quote": "相关原话"
  }
]

字段说明：

• local_id：本次解析的临时编号（"1" "2" ...），用于 depends_on_local_ids 引用
• assignee：Gitea 用户名（参考 attendees 列表）
• due_date：YYYY-MM-DD 格式
• depends_on_local_ids：依赖的其他任务 local_id 列表（无依赖则为 []）
• quote：原话引用（来自 confirmed_issue.md 中的 > "..." 内容）

如果解析结果为空数组（无待办），跳过第三步，直接进入第四步（finish）。

---

第三步（仅单项目会议）：调用 create-issues 批量建 Gitea issue

bash

node main.js create-issues \
  --repo "HKU-AIFusion/dexterous-hand" \
  --meeting-dir "2026-04-22-1500" \
  --topic "v2 设计评审" \
  --issues-json '[{"local_id":"1","task":"...","assignee":"sujinze","due_date":"2026-04-29","depends_on_local_ids":[],"quote":"..."}]'

本命令会：

1. 第一轮：为每条 action item 在仓库创建 Gitea issue
   • Title：任务描述
   • Labels：meeting-action、meeting:YYYY-MM-DD-HHMM
   • Assignee：指定用户名
   • Due Date：截止日期（若 Gitea 版本支持）
   • Body：包含原话引用 + 会议目录链接
2. 第二轮：回填依赖关系（在 issue body 追加 Depends-on: #N 行）
3. 返回 local_id → issue_number 映射，供 finish 写入 meta.yaml

返回 JSON，关键字段：

• success
• created：[{local_id, issue_number, issue_url, assignee, task}]
• failed：[{local_id, task, error}]（部分失败时非空）

跨项目会议跳过此步骤，直接进入第四步。

---

第四步：调用 finish 收尾

bash

node main.js finish \
  --repo "HKU-AIFusion/dexterous-hand" \
  --meeting-dir "2026-04-22-1500" \
  --topic "v2 设计评审" \
  --category "single" \
  --organizer-email "[e-mail]" \
  --attendee-emails "[e-mail],[e-mail]" \
  [--created-issues-json '[{"local_id":"1","issue_number":42,"issue_url":"...","assignee":"sujinze","task":"..."}]'] \
  [--failed-issues-json '[...]']

本命令会：

1. 将 meta.yaml status → minutes-published，写入 created_issues 字段（issue 编号列表）
2. 写日志
3. 生成并返回三种邮件参数：
   • minutes_email：正式纪要邮件，发给全体参会人（含 minutes.md 内容摘要 + issue 列表链接）
   • assignee_emails：每位 assignee 的个人任务通知邮件（数组，每人一封）
   • cross_email：跨项目会议时，给组织者的建议邮件（含 confirmed_issue.md 完整内容）

---

第五步：调用 imap-smtp-email 发送邮件

单项目会议：

1. 发送正式纪要邮件（minutes_email）：

   • 收件人：全体参会人（minutes_email.to）
   • 主题：minutes_email.subject
   • 正文：minutes_email.html

2. 逐一发送个人任务通知（assignee_emails 数组，每人一封）：

   • 收件人：单人邮箱（assignee_emails[i].to）
   • 主题：assignee_emails[i].subject
   • 正文：assignee_emails[i].html

跨项目会议：

发送组织者建议邮件（cross_email）：

• 收件人：cross_email.to（组织者邮箱）
• 主题：cross_email.subject
• 正文：cross_email.html

---

错误处理规则

错误场景	处理方式
check 发现 status 不符	返回 valid=false + reason，OpenClaw 告知用户
check 发现 confirmed_issue.md 不存在	返回 valid=false，OpenClaw 提示用户先改文件名
confirmed_issue.md 解析结果为空	跳过 create-issues，finish 时 created_issues=[]
某条 issue 创建失败	继续创建其他，failed 列表记录，finish 后邮件提醒组织者
依赖回填失败	不影响 issue 本身，日志警告
finish 写 Gitea 失败	报错，OpenClaw 提示用户重试（可再次调用 confirm 触发）
邮件发送失败	状态已更新为 minutes-published，日志标注 email_failed

---

幂等性说明

• check：只读，天然幂等
• create-issues：若 meta.yaml 已是 minutes-published，拒绝执行（避免重复建 issue）
• finish：若 meta.yaml 已是 minutes-published，返回幂等成功（不重复写）
• webhook：同一次 push 若重复触发，check 的状态校验会拦截