用途
gsd-add-todo 是一个用于“从当前对话上下文中捕获想法或任务为待办事项(todo)”的技能。它主要用于在对话过程中快速记录想法或任务,将其结构化保存为 todo 文件,并同步更新项目状态、提交 Git。
主要能力
根据资料,该技能路由到 add-todo 工作流,工作流负责以下逻辑:
- 目录结构创建(Directory ensuring / Directory structure creation)
- 从参数或对话中提取内容(Content extraction from arguments or conversation)
- 根据文件路径推断领域(Area inference from file paths)
- 重复项检测与处理(Duplicate detection and resolution / Duplicate checking)
- 生成带 frontmatter 的 todo 文件(Todo file creation with frontmatter,含 slug 生成)
- 更新 STATE.md(STATE.md updates)
- 执行 Git 提交(Git commits)
- 已有领域检查(Existing area checking)
状态在工作流内通过 init todos 和定向读取来解析(State is resolved in-workflow via init todos and targeted reads)。
使用方式
该技能通过提及 $gsd-add-todo 来调用。所有 $gsd-add-todo 之后的用户文本会被视为 {{GSD_ARGS}}。如果未提供参数,{{GSD_ARGS}} 视为空。
资料包含一份 <codex_skill_adapter> 适配说明,涉及以下映射规则:
- Skill Invocation:通过
$gsd-add-todo调用,其后文本作为 {{GSD_ARGS}}。 - AskUserQuestion → request_user_input 映射:参数 header → header,question → question;选项由 “Label” — description 格式转为
{label: "Label", description: "description"};id 由 header 生成(小写、空格替换为下划线);批量调用AskUserQuestion([q1, q2])转为单个带多个 questions[] 条目的 request_user_input;Codex 无 multiSelect,可用顺序单选或编号自由列表(让用户输入逗号分隔的数字);当 request_user_input 被拒绝(Execute mode)时,回退为纯文本编号列表并选取合理默认值。 - 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)。
执行上下文指向 @/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/add-todo.md。
适用场景
适用于在对话过程中捕捉想法或任务、将其记录为结构化 todo,并需要同步状态文件和进行版本提交的工作流场景。
限制
资料未提供安装命令、价格、平台支持范围、具体文件格式细节等信息,这些内容暂未提供。