SuperAPI AI 工具集

init-effort

编程与开发

查看项目

更新于 10-16 04:27

技能介绍

用途

Init Effort 用于启动一项“effort”。所谓 effort,是指大到足以拥有自己分支和拉取请求的工作:一个功能、一个新应用、一次重构、一次重新架构。日常维护工作(例如数据编辑和小修复)应在当前检出中完成,不使用本技能;项目可以自行列出哪些工作算作日常维护。

该技能同时负责 effort 当下的思考阶段和之后的构建阶段,二者都发生在它创建的 worktree 中。所有写入只应进入该 worktree;对于新项目,还包括新建的仓库。这样,本会话启动时所在的仓库保持原样不变。

主要能力

  • 判断 effort 的归属:是现有仓库中的 effort(当前仓库或想法中指定的仓库),还是尚无仓库的新项目。
  • 命名:提出简短的 kebab-case effort 名称,以及符合项目分支命名规范的分支名;若项目没有规范,则使用 <area>/<effort>。两者都需与维护者确认。
  • 新项目:先提出几个项目名并确认一个;询问采用哪种许可证(推荐以维护者名义使用 MIT);询问其 GitHub 仓库是公开还是私有;然后阅读 project-creation.md,创建并推送仓库。
  • 使用 <worktree-tool> 从远程默认分支在新分支上创建 worktree。当工作基于本地默认分支上尚未推送的提交时,改为从本地默认分支创建分支。
  • 将想法写入 worktree 中的 handoff 文件,位置为项目的 handoff 文件夹,否则为 .handoff/<date>-<effort>.md。文件包含维护者给出的原始想法、effort、分支和 worktree;对于新项目,还包含其仓库。
  • 启动思考会话:通过 <session-host> 在 worktree 中启动 <agent>,传入 worktree、作为主题的 effort、thinking 角色以及下面的起始提示。
  • 当它在另一个会话中运行时:告知维护者位置,并在 <session-host> 报告其正在处理提示或维护者表示已启动后停止。

使用方式

技能接受以下参数:

  • <worktree-tool>:创建和释放 worktree 的工具,例如 treehouse,或普通的 git worktree。
  • <session-host>:代理会话运行的位置,例如 herdr、Claude Code Desktop、Codex Desktop。
  • <agent>:启动新代理会话的命令,例如 claude 或 codex,及其标志。

流程如下:

  1. 决定 effort 的归属:现有仓库中的 effort(当前仓库或想法中指定的仓库),或尚无仓库的新项目。
  2. 命名。提出简短的 kebab-case effort 名称,以及符合项目分支命名规范的分支名;若项目没有规范,则使用 <area>/<effort>。与维护者确认两者。
  3. 对于新项目:先提出几个项目名并确认一个。
  4. 仅对于新项目,创建它。询问采用哪种许可证,推荐以维护者名义使用 MIT。同时询问其 GitHub 仓库是公开还是私有。然后阅读 project-creation.md,创建并推送仓库。
  5. 使用 <worktree-tool> 从远程默认分支在新分支上创建 worktree。
  6. 当工作基于本地默认分支上尚未推送的提交时,改为从本地默认分支创建分支。
  7. 将想法写入 worktree 中的 handoff 文件,位置为项目的 handoff 文件夹,否则为 .handoff/<date>-<effort>.md。文件包含维护者给出的原始想法、effort、分支和 worktree。对于新项目,还包含其仓库。
  8. 启动思考会话:通过 <session-host> 在 worktree 中启动 <agent>,传入 worktree、作为主题的 effort、thinking 角色以及下面的起始提示。
  9. 当它在另一个会话中运行时:告知维护者位置,并在 <session-host> 报告其正在处理提示或维护者表示已启动后停止。

起始提示只有一行,因为多行提示会作为粘贴文本到达,其技能永远不会启动:

Think through the effort in <handoff path>: grill me on it with the grilling skill, using the prototype skill when a question needs a runnable answer, then write the spec with to-spec and the tickets with to-tickets, and hand over to an orchestrator with the handover skill.

该提示只包含代理可以加载的技能。

适用场景

  • 启动一个需要独立分支和拉取请求的新功能。
  • 启动一个新应用或全新项目,并为其创建独立仓库。
  • 启动一次重构或重新架构。
  • 需要将想法先经过追问、原型验证、规格编写、工单拆分,再移交给编排器的场景。

限制

  • 日常维护工作(如数据编辑和小修复)不应使用本技能,应在当前检出中完成。
  • 所有写入只应进入该技能创建的 worktree;对于新项目,还包括新仓库,以保持原会话所在仓库不变。
  • 起始提示必须是一行,多行提示会作为粘贴文本到达,其技能不会启动。
  • 起始提示只包含代理可以加载的技能。
  • 关于许可证、仓库可见性等选择需要维护者确认。
  • 资料中未提供该技能的安装命令、收费或价格信息。