用途
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,及其标志。
流程如下:
- 决定 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>报告其正在处理提示或维护者表示已启动后停止。
起始提示只有一行,因为多行提示会作为粘贴文本到达,其技能永远不会启动:
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;对于新项目,还包括新仓库,以保持原会话所在仓库不变。
- 起始提示必须是一行,多行提示会作为粘贴文本到达,其技能不会启动。
- 起始提示只包含代理可以加载的技能。
- 关于许可证、仓库可见性等选择需要维护者确认。
- 资料中未提供该技能的安装命令、收费或价格信息。