# THX-cctv-image-gen 出图任务归档与 GitHub Issue 流程

本流程用于让运营同事在 Codex 中出图后自动留下可审阅记录。目标不是让运营转发结果给负责人，而是让负责人直接在 GitHub Issue 池里查看每次任务、图片、Prompt、自检、失败原因和最终可用图。

## 默认仓库

首版使用：

```text
haloshin/bird-feeder-image-generator
```

该仓库作为 `THX-cctv-image-gen` 的出图任务 Issue 池。Issue 记录任务过程；图片归档到服务器静态目录，Issue 中引用图片链接。

## 图片归档位置

本地归档：

```text
THX-cctv-image-gen/runs/YYYY-MM-DD/<run-id>/
```

线上归档：

```text
http://8.135.42.221/thx-workbuddy/cctv-image-gen/runs/YYYY-MM-DD/<run-id>/
```

每个 run 至少包含：

| 文件 | 用途 |
|---|---|
| `request.md` | 原始需求 |
| `prompt.txt` | 本次实际传给 image2 的 Prompt |
| `self-check.md` | Skill 自检结论 |
| `operator-feedback.md` | 运营反馈或负责人判断 |
| `assets/image-01.*` | 候选图 |
| `assets/final.*` | 最终可用图，如果已有 |
| `issue.md` | GitHub Issue 正文 |
| `manifest.json` | run 元数据 |
| `issue-url.txt` | Issue 创建成功后的链接 |

## Issue 标题

格式固定为：

```text
[THX-cctv-image-gen][产品名][平台/用途] 任务摘要
```

示例：

```text
[THX-cctv-image-gen][野鸟V8][TikTok] 红雀叼种子
```

## Issue 必填内容

每条 Issue 必须包含：

- 原始需求。
- 产品名、平台用途、Run ID。
- 候选图链接；如果已有最终图，单独标出最终可用图。
- 本次使用 Prompt。
- Skill 自检结论。
- 运营反馈或负责人判断。
- 当前状态：`待判断` / `需返修` / `可用` / `废弃`。
- 是否需要进入 GBrain：`是` / `否` / `待判断`。
- 建议处理：更新 Prompt、更新产品结构词典、更新自检标准、进入 GBrain 候选等。

## 标签

首版自动使用这些标签：

```text
cctv-image-gen
status:待判断
status:需返修
status:可用
status:废弃
gbrain-candidate
```

产品名、平台名先写在标题和 Issue 表格中，不急着做大量标签，避免标签池过早膨胀。

## GBrain 分流规则

Issue 不等于 GBrain。

进入 GBrain 候选的内容：

- 产品名与真实结构关系。
- 产品结构纠错。
- 可复用 Prompt 规则。
- 可复用自检标准。
- 可复用返修 SOP。
- 某产品分支长期失败规律。

只留在 Issue 的内容：

- 单张图不好看。
- 单次构图偏满。
- 某张鸟姿态不自然。
- 一次性审美判断。
- 未确认的猜测。

如果 Issue 中出现 GBrain 候选，先打 `gbrain-candidate` 标签；负责人确认后再走 `THX-GBrain-update` 或 Context MCP 的 `submit_gbrain_feedback`，不要由本 Skill 直接修改 GBrain 主库。

## 脚本

创建归档并提交 Issue：

```bash
/Users/shin/.claude/skills/THX-cctv-image-gen/scripts/create-image-run-issue.sh \
  --product "野鸟V8" \
  --platform "TikTok" \
  --request "野鸟V8，红雀叼种子，TikTok 图" \
  --summary "红雀叼种子" \
  --prompt-file /path/to/prompt.txt \
  --self-check-file /path/to/self-check.md \
  --image /path/to/image.jpg \
  --status "待判断" \
  --result "待判断"
```

脚本会：

1. 创建本地 run 目录。
2. 复制 Prompt、自检、反馈和图片。
3. 同步 run 到服务器静态目录。
4. 创建或复用 GitHub 标签。
5. 创建 GitHub Issue。
6. 把 Issue URL 写入 `issue-url.txt`。

追加运营反馈、返修图或最终可用图：

```bash
/Users/shin/.claude/skills/THX-cctv-image-gen/scripts/append-image-run-feedback.sh \
  --issue 1 \
  --run-dir /path/to/run \
  --feedback "这张可用，产品结构和监控感都可以。" \
  --status "可用" \
  --result "可用" \
  --final-image /path/to/final.jpg
```

该脚本会：

1. 把反馈写入 run 目录。
2. 复制返修图或最终可用图。
3. 同步到服务器静态目录。
4. 在同一个 GitHub Issue 下追加评论。
5. 更新状态标签；如果标记为 `可用`，自动关闭 Issue。

## 正式运营使用口径

运营同事只需要发短需求：

```text
请使用 THX-cctv-image-gen，直接出图：野鸟V8，红雀叼种子，TikTok 图。
```

Codex 应自动完成：

```text
出图 → 自检 → 归档图片与 Prompt → 提交 GitHub Issue → 返回图片与 Issue 链接
```

运营继续反馈时，Codex 应自动完成：

```text
识别反馈 → 更新同一个 Issue → 追加返修图或最终图 → 更新状态标签 → 必要时标记 GBrain 候选
```

运营不需要懂 GitHub，也不需要把结果转发给负责人。负责人在 Issue 池中判断哪张图不好、为什么不好、哪张最终可用，以及哪些规则需要沉淀。
