Agent Skills
› NeverSight/learn-skills.dev
› gsd-capture
gsd-capture
GitHub用于捕获想法、任务、笔记和种子。提供从GSD工作流到Codex的语法映射，处理用户输入请求及子代理生成逻辑，确保在获取明确指令前不擅自执行或写入文件。
Trigger Scenarios
提及 $gsd-capture
需要记录想法或任务
Install
npx skills add NeverSight/learn-skills.dev --skill gsd-capture -g -y
SKILL.md
Frontmatter
{
"name": "gsd-capture",
"metadata": {
"short-description": "Capture ideas, tasks, notes, and seeds to their destination"
},
"description": "Capture ideas, tasks, notes, and seeds to their destination"
}
<codex_skill_adapter>
A. Skill Invocation
- This skill is invoked by mentioning
$gsd-capture. - Treat all user text after
$gsd-captureas{{GSD_ARGS}}. - If no arguments are present, treat
{{GSD_ARGS}}as empty.
B. AskUserQuestion → request_user_input Mapping
GSD workflows use AskUserQuestion (Claude Code syntax). Translate to Codex request_user_input:
Parameter mapping:
header→headerquestion→question- Options formatted as
"Label" — description→{label: "Label", description: "description"} - Generate
idfrom header: lowercase, replace spaces with underscores
Batched calls:
AskUserQuestion([q1, q2])→ singlerequest_user_inputwith multiple entries inquestions[]
Multi-select workaround:
- Codex has no
multiSelect. Use sequential single-selects, or present a numbered freeform list asking the user to enter comma-separated numbers.
Execute mode fallback:
- When
request_user_inputis rejected or unavailable, you MUST stop and present the questions as a plain-text numbered list, then wait for the user's reply. Do NOT pick a default and continue (#3018). - You may only proceed without a user answer when one of these is true:
(a) the invocation included an explicit non-interactive flag (
--autoor--all), (b) the user has explicitly approved a specific default for this question, or (c) the workflow's documented contract says defaults are safe (e.g. autonomous lifecycle paths). - Do NOT write workflow artifacts (CONTEXT.md, DISCUSSION-LOG.md, PLAN.md, checkpoint files) until the user has answered the plain-text questions or one of (a)-(c) above applies. Surfacing the questions and waiting is the correct response — silently defaulting and writing artifacts is the #3018 failure mode.
C. Task() → spawn_agent Mapping
GSD workflows use Task(...) (Claude Code syntax). Translate to Codex collaboration tools:
Direct mapping:
Task(subagent_type="X", prompt="Y")→spawn_agent(agent_type="X", message="Y")Task(model="...")→ omit.spawn_agenthas no inlinemodelparameter; GSD embeds the resolved per-agent model directly into each agent's.tomlat install time somodel_overridesfrom.planning/config.jsonand~/.gsd/defaults.jsonare honored automatically by Codex's agent router.fork_context: falseby default — GSD agents load their own context via<files_to_read>blocks
Spawn restriction:
- Codex restricts
spawn_agentto cases where the user has explicitly requested sub-agents. When automatic spawning is not permitted, do the work inline in the current agent rather than attempting to force a spawn.
Parallel fan-out:
- Spawn multiple agents → collect agent IDs →
wait(ids)for all to complete
Result parsing:
- Look for structured markers in agent output:
CHECKPOINT,PLAN COMPLETE,SUMMARY, etc. close_agent(id)after collecting results from each agent </codex_skill_adapter>
Mode routing:
- default (no flag): Capture as a structured todo for later work → add-todo workflow
- --note: Zero-friction idea capture (append/list/promote) → note workflow
- --backlog: Add an idea to the backlog parking lot (999.x numbering) → add-backlog workflow
- --seed: Capture a forward-looking idea with trigger conditions → plant-seed workflow
- --list: List pending todos and select one to work on → check-todos workflow
| Flag | Destination | Workflow |
|---|---|---|
| (none) | Structured todo in .planning/todos/ | add-todo |
| --note | Timestamped note file, list, or promote | note |
| --backlog | ROADMAP.md backlog section (999.x) | add-backlog |
| --seed | .planning/seeds/SEED-NNN-slug.md | plant-seed |
| --list | Interactive todo browser + action router | check-todos |
<execution_context> @/Users/machado/Projects/folhario/.codex/get-shit-done/workflows/add-todo.md @/Users/machado/Projects/folhario/.codex/get-shit-done/workflows/note.md @/Users/machado/Projects/folhario/.codex/get-shit-done/workflows/add-backlog.md @/Users/machado/Projects/folhario/.codex/get-shit-done/workflows/plant-seed.md @/Users/machado/Projects/folhario/.codex/get-shit-done/workflows/check-todos.md @/Users/machado/Projects/folhario/.codex/get-shit-done/references/ui-brand.md </execution_context>
Parse the first token of {{GSD_ARGS}}:
- If it is
--note: strip the flag, pass remainder to note workflow - If it is
--backlog: strip the flag, pass remainder to add-backlog workflow - If it is
--seed: strip the flag, pass remainder to plant-seed workflow - If it is
--list: pass remainder (optional area filter) to check-todos workflow - Otherwise: pass all of {{GSD_ARGS}} to add-todo workflow
Version History
- e0220ca Current 2026-07-05 23:35
