用途
gsd-thread 用于管理持久化的上下文线程，服务于跨会话的持续性工作。它由 $gsd-thread 触发，将用户在该指令之后的文本作为参数处理；若无参数则视为空。
主要能力
- 列线程：无参数时执行 ls .planning/threads/*.md，读取各线程文件开头以展示标题与状态，以表格列出线程名、状态和最后更新时间；若无线程则提示用 $gsd-thread <description> 创建。
- 恢复线程：当参数与已有线程文件名匹配时，载入该线程文件内容到当前会话，展示线程内容并询问下一步工作；若原状态为 OPEN，更新为 IN PROGRESS。
- 创建线程：当参数是新的描述且没有匹配线程文件时，用 gsd-tools 生成 slug，创建 .planning/threads 目录并写入线程文件，模板包含 Thread 标题、Status: OPEN、Goal、Context、References、Next Steps 等栏目；如当前对话含相关上下文（代码片段、错误信息、调查结果）可抽取填入 Context 部分；随后通过 gsd-tools commit 提交该文件。
使用方式
- 列出：仅输入 $gsd-thread。
- 恢复：$gsd-thread <已有线程名>。
- 创建：$gsd-thread <新描述>。
创建流程中使用的命令示例：
SLUG=$(node "/mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs" generate-slug "{{GSD_ARGS}}")
mkdir -p .planning/threads
cat > ".planning/threads/${SLUG}.md" << 'EOF'
...
EOF
node "/mnt/local-analysis/workspace-hub/.codex/get-shit-done/bin/gsd-tools.cjs" commit "docs: create thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
适用场景
适用于需要跨多个会话延续同一主题的工程或文档工作，例如修复部署密钥认证、TCP 超时调查、性能排查等，通过线程文件保留目标、上下文与下一步，便于下次会话继续。
限制与适配说明
技能文档包含 codex_skill_adapter 适配层说明：将 Claude Code 语法的 AskUserQuestion 映射为 Codex 的 request_user_input（header→header、question→question，选项由 Label 与 description 转为 {label, description}，id 由 header 生成，小写并把空格替换为下划线）；批量调用合并为单个 request_user_input 的多条目 questions[]；Codex 无 multiSelect，需用连续单选或编号自由列表让用户输入逗号分隔编号；Execute 模式拒绝 request_user_input 时，改用纯文本编号列表并选取合理默认值。将 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)。除上述资料明确内容外，其他功能、收费、平台、效果等信息暂未提供。