SuperAPI AI 工具集

gsd-health

办公与效率

查看项目

更新于 10-16 06:26

技能介绍

用途

gsd-health 用于诊断规划目录的健康状况,并可选择性地修复发现的问题。根据技能说明,它属于 GSD(get-shit-done)工作流体系中的一个技能。

主要能力

  • 诊断规划目录的健康状况。
  • 可选地修复检测到的问题(说明描述为 "optionally repair issues")。

具体可诊断哪些健康维度、修复哪些类型的问题,资料中暂未提供。

使用方式

该技能通过提及 $gsd-health 来调用。调用时,$gsd-health 之后的所有用户文本被视为 {{GSD_ARGS}};如果没有参数,则将 {{GSD_ARGS}} 视为空。

执行上下文指向工作流文件:@/mnt/local-analysis/workspace-hub/.codex/get-shit-done/workflows/health.md。

Codex 适配说明

技能说明中包含一份 codex_skill_adapter,用于将 Claude Code 语法映射到 Codex:

  • 技能调用:通过 $gsd-health 触发,其后文本作为 {{GSD_ARGS}}。
  • 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 被拒绝(执行模式)时,呈现纯文本编号列表并选择一个合理的默认值。
  • 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 工作流、需要检查规划目录是否健康并在必要时进行修复的场景。具体的目录结构、诊断项和修复策略,资料中暂未提供。

限制

  • 资料中仅提供了技能调用的适配说明与执行上下文引用,未提供 health.md 工作流的实际内容。
  • 具体支持哪些参数({{GSD_ARGS}} 的取值)、诊断的判定标准、修复的边界与风险,均暂未提供。
  • 运行依赖 Codex 的协作工具(request_user_input、spawn_agent、wait、close_agent)以及相应的工作流文件路径。