SuperAPI AI 工具集

gsd-new-project

编程与开发

查看项目

更新于 10-16 06:09

技能介绍

用途

gsd-new-project 是一个项目初始化技能,目标是在新项目启动阶段进行深度上下文收集,并生成一套结构化的规划文件(以 PROJECT.md 为核心)。它属于 GSD(get-shit-done)工作流的一部分,用于把项目从零散想法推进到可执行的阶段规划。

主要能力

根据资料,该技能会创建以下文件:

  • .planning/PROJECT.md — 项目上下文
  • .planning/config.json — 工作流偏好
  • .planning/research/ — 领域研究(可选)
  • .planning/REQUIREMENTS.md — 范围化需求
  • .planning/ROADMAP.md — 阶段结构
  • .planning/STATE.md — 项目记忆

使用方式

该技能通过提及 $gsd-new-project 来调用。用户在该指令之后输入的所有文本会被视为 {{GSD_ARGS}};如果没有参数,则 {{GSD_ARGS}} 视为空。

初始化完成后,运行 $gsd-plan-phase 1 即可开始执行。

资料还包含一个 Codex 技能适配层(codex_skill_adapter),用于把 GSD 工作流中使用的 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 工作流、希望在编码前先明确项目上下文、需求范围、阶段路线图与项目记忆的团队或个人。

限制

资料未提供该技能的收费、价格、平台支持范围、效果保证或具体安装命令等信息,这些内容暂未提供。技能的具体行为依赖其引用的执行上下文文件(位于 .codex/get-shit-done/ 下的 workflows、references 与 templates),资料中未展开这些文件的具体内容。