← ClaudeAtlas

pekoe-worklisted

pekoe の作業セッション(pekoe new で作られた linked worktree で動くエージェント)として、任された変更を計画 → 実装 → テスト → 独立レビュー → コミット → pekoe land → pekoe report まで進める。cwd が pekoe の worktree で、プロンプトが tapi・main・人から来た作業の依頼のときに使う。報告の書き方、詰まったときの pekoe report --status blocked と pekoe ask-human の使い分けも。
sakamosu/pekoe · ★ 0 · AI & Automation · score 68
Install: claude install-skill sakamosu/pekoe
# pekoe の作業セッションで任された作業を進める 自分は依頼元(tapi・main のエージェント・人)から 1 つの作業を任されたセッション。この worktree で直接作業し、終わったら結果と証拠を `pekoe report` で依頼元に返す。依頼元は報告を `pekoe wait` で待っているので、報告しないと終わったことが伝わらない。 - 自分がセッションの側かは pekoe スキルの判定(`git rev-parse --path-format=absolute --git-dir --git-common-dir` の 2 行が違う = linked worktree)で確かめる - この worktree で直接編集する。`pekoe new` で孫セッションを作らない(並行させたい明確な理由があるときを除く) - プロンプトの完了条件・やらないことを最優先にする。下の手順と食い違えば(「push しない」「land しない」など)プロンプトに従う ## 流れ 1. **計画**: プロンプトを読み、関係するコードを調べ、何をどう変えるかを決める。完了条件が曖昧なら、自分で妥当な線を決めて報告に書く(依頼元に聞くのは、決めようがないときだけ。下の「詰まったら」) 2. **実装**: リポジトリの CLAUDE.md・既存の書き方に合わせる。範囲外の変更をしない 3. **テスト**: リポジトリのテストを実際に動かす。新しい振る舞いにはテストを足す 4. **確かめる**: 下の「確かめ方」。テストが通っただけで終わりにしない 5. **独立レビュー**: 下の「独立レビュー」 6. **コミット**: 論理単位で分ける。メッセージはリポジトリの慣習に合わせる 7. **land**: `pekoe land <slug>`(slug は `$PEKOE_SESSION`)。rebase → テスト → push → PR 作成を pekoed がやる。失敗したら理由を読んで直し、もう一度。マージは人がする 8. **報告**: `pekoe report`(下) ## 確かめ方 - 「CI が通った」「テストが通った」だけでは確かめたことにならない。変えた振る舞いを実際に動かして見る - UI: 画面のスクショか GIF を撮り、パスを evidence に付ける。自分の sandbox ではポートを開けないので、dev server は `pekoe dev <自分の slug>`(`$PEKOE_SESSION`)で pekoed に起動してもらう(リポジトリの設定の `[hooks] dev` が、セッションのポートで pekoe の sandbox の中で動く。ポートは `pekoe --json ls` の `port`、動いているかは `dev`。自分で終わったら `dev` は false になり、`dev_exit` に終了コード。出力は `pekoe dev --log` で末尾を読める)。受信箱で人に頼まない。同じコマンドは起動と停止を切り替える(動いている間に打つと止まる)ので、確かめ終わったら止める。効くのは自分のセッションだけで、別の slug は断られる。`[hooks] dev` が無い・つなげない(sandbox が localhost への接続を断る)ときは、そう報告に書く - API・CLI: 実際のリクエストとレスポンス(コマンドと出力)をファイルに残し、ev