gsd-add-backlog

用途

gsd-add-backlog 用于把一个想法添加到待办积压区（backlog parking lot），使用 999.x 编号体系进行标识。它属于 GSD（get-shit-done）工作流的一部分，目的是将尚未准备好进入正式规划的想法先暂存起来，避免丢失，同时不干扰当前活跃的里程碑。

主要能力

读取 .planning/ROADMAP.md，查找已有的积压条目。
计算下一个可用的积压编号：若不存在 999.x 阶段，则从 999.1 开始。
为积压条目创建阶段目录，并生成对应的 slug。
在 ROADMAP.md 的 ## Backlog 章节中登记该条目；若该章节不存在，则在文件末尾创建。
提交变更到版本控制。

使用方式

该技能通过提及 $gsd-add-backlog 来调用。$gsd-add-backlog 之后的所有用户文本被视为 {{GSD_ARGS}}；若无参数，则 {{GSD_ARGS}} 视为空。

技能内部执行的主要步骤（命令与代码保持原样）：

读取 ROADMAP.md 查找现有积压条目：

cat .planning/ROADMAP.md

查找下一个积压编号：

NEXT=$(node "/mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs" phase next-decimal 999 --raw)

若不存在 999.x 阶段，则从 999.1 开始。

SLUG=$(node "/mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs" generate-slug "{{GSD_ARGS}}")
mkdir -p ".planning/phases/${NEXT}-${SLUG}"
touch ".planning/phases/${NEXT}-${SLUG}/.gitkeep"

在 ROADMAP.md 的 ## Backlog 章节下添加条目；若该章节不存在，则在末尾创建：

## Backlog

### Phase {NEXT}: {description} (BACKLOG)

**Goal:** [Captured for future planning]
**Requirements:** TBD
**Plans:** 0 plans

Plans:
- [ ] TBD (promote with $gsd-review-backlog when ready)

提交：

node "/mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs" commit "docs: add backlog item ${NEXT} — ${ARGUMENTS}" --files .planning/ROADMAP.md ".planning/phases/${NEXT}-${SLUG}/.gitkeep"

报告：

## 📋 Backlog Item Added

Phase {NEXT}: {description}
Directory: .planning/phases/{NEXT}-{slug}/

This item lives in the backlog parking lot.
Use $gsd-discuss-phase {NEXT} to explore it further.
Use $gsd-review-backlog to promote items to active milestone.

适配说明（Codex）

该技能包含一个 codex_skill_adapter 适配层，用于将 Claude Code 语法映射到 Codex 工具：

AskUserQuestion → request_user_input：参数 header → header，question → question；选项格式 "Label" — description 映射为 {label: "Label", description: "description"}；id 由 header 生成（小写、空格替换为下划线）。批量调用 AskUserQuestion([q1, q2]) 映射为单个 request_user_input，在 questions[] 中包含多个条目。Codex 无 multiSelect，可用连续单选或编号自由列表（让用户输入逗号分隔的数字）替代。当 request_user_input 被拒绝（Execute 模式）时，回退为纯文本编号列表并选取合理默认值。
Task() → spawn_agent：Task(subagent_type="X", prompt="Y") 映射为 spawn_agent(agent_type="X", message="Y")；Task(model="...") 省略（Codex 使用按角色配置，而非内联模型选择）；fork_context 默认 false，GSD 代理通过 <files_to_read> 块加载自身上下文。并行扇出时，生成多个代理 → 收集代理 ID → wait(ids) 等待全部完成。结果解析时查找代理输出中的结构化标记：CHECKPOINT、PLAN COMPLETE、SUMMARY 等。收集每个代理结果后调用 close_agent(id)。

适用场景

在 GSD 工作流中快速记录尚未规划的想法。
需要将想法暂存而不立即进入活跃里程碑时。
后续可通过 $gsd-discuss-phase {NEXT} 进一步探索，或通过 $gsd-review-backlog 将条目提升为活跃里程碑。

限制

该技能依赖 GSD 工具链（gsd-tools.cjs）与 .planning 目录结构。
关于收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途

主要能力

使用方式

适配说明（Codex）

适用场景

限制