# Producer

> 与用户对话创建可执行任务；在 plan mode 下明确目标、方法、验证手段并控制复杂度，然后将任务追加到 TASK_QUEUE.md。

- Skill: `xlinsist/producer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xlinsist/producer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xlinsist/producer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xlinsist (https://skillmd.com/u/xlinsist)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xlinsist/producer

---


# Producer

用于“产出任务，不执行任务”。

## 职责边界

- 只负责和用户澄清需求并创建任务。
- 不负责具体实现与收尾。
- 每次创建任务都要控制复杂度，确保消费者可独立闭环。

## 工作流

1. 进入计划阶段
- 与用户对话时使用 plan mode（例如先进入 `/plan` 再收敛任务）。
- 先确认任务是否可在一次闭环中完成；若过大，先切分。

2. 生成 SSD 任务定义（最小闭环）
- 必填字段：
  - `goal`：目标（可验收）
  - `scope_in`：包含范围
  - `scope_out`：不包含范围
  - `constraints`：约束（环境/时间/依赖/不允许事项）
  - `method`：方法（步骤 2-5 条，避免大而空）
  - `verification`：验证命令（必须 `cmd: <shell command>`）
  - `done_definition`：完成定义（明确何时算完成）
  - `risk`：主要风险与兜底
  - `complexity`：复杂度（S/M/L，默认 S 或 M）
  - `notes`：上下文与限制（可选）

3. 写入队列
- 任务写入仓库根目录 `TASK_QUEUE.md`。
- 新任务统一追加到 `## Queue` 下方，状态固定为 `todo`。
- 任务 ID 使用递增格式：`T-0001`、`T-0002`...
- 写入成功后，自动调用 `skills/consumer/scripts/ensure_consumer.sh` 触发后台消费。

推荐直接使用脚本入队（会自动触发 consumer）：

```bash
bash skills/producer/scripts/add_task.sh \
  /home/zxl/paper/academic-skills \
  --goal "目标描述" \
  --scope-in "纳入范围" \
  --scope-out "排除范围" \
  --constraints "资源/时间/依赖约束" \
  --method "step1; step2; step3" \
  --verification "cmd: <shell command>" \
  --done-definition "满足哪些条件即完成" \
  --risk "主要风险与回退策略" \
  --complexity "S" \
  --notes "可选备注"
```

## 队列写入格式

使用下面的单行模板追加：

```markdown
- [ ] T-0001 | status: todo | owner: consumer | goal: ... | scope_in: ... | scope_out: ... | constraints: ... | method: ... | verification: cmd: ... | done_definition: ... | risk: ... | complexity: S | created: YYYY-MM-DD
```

要求：
- `goal/scope_in/scope_out/constraints/method/verification/done_definition/risk` 必须具体。
- `method` 可以用 `step1; step2; step3` 的紧凑形式。
- `verification` 必须写成 `cmd: <shell command>`。
- 默认不接受 `complexity: L`，除非显式允许。
- 不向队列写入缺少 SSD 字段的任务。

## 质量门禁

在写入前自检：

- 目标是否可在一次实现中完成。
- scope 是否边界清晰（in/out 不冲突）。
- constraints 是否明确可执行限制。
- 方法是否不超过 5 步。
- 验证是否可执行且有通过标准。
- done_definition 是否可客观判定。
- risk 是否给出兜底。
- 复杂度是否为 S/M/L 且与任务规模一致。
- 不与队列中的在途任务重复。