init-effort

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Init Effort

初始化 Effort

An effort is work big enough for its own branch and pull request: a feature, a new app, a refactor, a re-architecture. Do routine upkeep, such as data edits and small fixes, in the current checkout without this skill; the project may list what counts as routine there.

Both the effort's thinking now and its build later happen in the worktree this skill creates. Write only into that worktree and, for a new project, the new repo, so the repository this session was started in stays as it was.

一个 effort 是规模大到足以拥有独立 branch 和 pull request 的工作，例如一项功能、一个新应用、一次重构或一次架构调整。对于数据编辑和小修复等常规维护，不要使用此 skill；项目可能会在其中列出哪些内容属于常规维护。

当前对 effort 的思考和后续构建都将在此 skill 创建的 worktree 中进行。只能向该 worktree 中写入内容；对于新项目，还要写入新 repo 中，从而使本次 session 的起始 repository 保持原状。

Parameters

参数

```
<worktree-tool>
```
: the tool that makes and frees worktrees, e.g.
```
treehouse
```
, or plain git worktrees.
```
<session-host>
```
: where agent sessions run, e.g.
```
herdr
```
, Claude Code Desktop, Codex Desktop.
```
<agent>
```
: the command that starts a new agent session, e.g.
```
claude
```
or
```
codex
```
, with its flags.

```
<worktree-tool>
```
：用于创建和释放 worktree 的工具，例如
```
treehouse
```
或原生 git worktree。
```
<session-host>
```
：Agent session 的运行位置，例如
```
herdr
```
、Claude Code Desktop 或 Codex Desktop。
```
<agent>
```
：启动新 Agent session 的命令，例如
```
claude
```
或
```
codex
```
，并带上相应的 flags。

Flow

流程

Decide where it lives: an effort in an existing repo, which is the current one or one the idea names, or a new project that has no repo yet.
Name it. Propose a short kebab-case effort name, and a branch that follows the project's branch naming, or
```
<area>/<effort>
```
when the project has none. Confirm both with the maintainer.
- For a new project: first propose a few project names and confirm one.
For a new project only, create it. Ask which licence it takes, recommending MIT in the maintainer's name. Ask too whether its GitHub repo is public or private. Then read
```
project-creation.md
```
, and create and push the repo.
Create the worktree on the new branch with
```
<worktree-tool>
```
, from the remote default branch.
- When the work builds on unpushed commits on the local default branch, branch from the local one instead.
Write the idea into a handoff in the worktree, in the project's handoff folder, else at
```
.handoff/<date>-<effort>.md
```
. It holds the idea as the maintainer gave it, the effort, the branch and the worktree.
- For a new project: it also holds its repo.
Start the thinking session: start
```
<agent>
```
in the worktree through
```
<session-host>
```
, passing the worktree, the effort as the topic,
```
thinking
```
as the role, and the starting prompt below.
- When it runs in another session: tell the maintainer where, and stop once
```
<session-host>
```
  reports it working on the prompt or the maintainer says it started.

The starting prompt is one line, since a prompt of several lines arrives as pasted text and its skills never start:

text

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.

This prompt only includes skills an agent can load.

确定存放位置：现有 repo 中的 effort，即当前 repo 或想法中明确指定的 repo；或者尚未拥有 repo 的全新项目。
为其命名。 提出一个简短的 kebab-case effort 名称，并准备一个遵循项目 branch 命名规则的 branch；如果项目没有规则，则使用
```
<area>/<effort>
```
。向 maintainer 确认两者。
- 对于新项目： 先提出几个项目名称，并确认其中一个。
仅针对新项目进行创建。 询问它采用什么 license，并代表 maintainer 推荐 MIT。还需询问其 GitHub repo 是 public 还是 private。然后读取
```
project-creation.md
```
，并创建和推送 repo。
在新 branch 上创建 worktree：使用
```
<worktree-tool>
```
，从 remote 的默认 branch 创建。
- 如果该工作建立在本地默认 branch 上尚未推送的 commits 之上，则改为从本地 branch 创建。
将想法写入 handoff：在 worktree 中项目的 handoff 文件夹内写入 handoff；如果没有该文件夹，则写入
```
.handoff/<date>-<effort>.md
```
。其中应记录 maintainer 原样提出的想法、effort、branch 和 worktree。
- 对于新项目： 还需记录其 repo。
启动思考 session：通过
```
<session-host>
```
在 worktree 中启动
```
<agent>
```
，传入 worktree、以 effort 为 topic、将角色设为
```
thinking
```
，以及下面的起始 prompt。
- 当它在另一个 session 中运行时： 告知 maintainer 运行位置，并在
```
<session-host>
```
  报告其正在处理 prompt 或 maintainer 表示已经启动后停止。

起始 prompt 只有一行，因为多行 prompt 会作为粘贴文本传入，导致其 skills 无法启动：

text

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.

此 prompt 仅包含 Agent 能够加载的 skills。

References

参考资料

project-creation.md: creating a new project's repo: the name checks, the setup and the first commit.

project-creation.md：创建新项目 repo，包括名称检查、项目设置和首次 commit。