implementationlisted
Install: claude install-skill Tokfuel/Tokfuel
# GitHub Issue の実装
Tokfuel の GitHub Issue を 1 件、提案の状態から出荷済みの緑のコードまで運ぶ。判定は常に
`swift build`(と組み込みのレビュー系スキル)であって、LLM の心証ではない。仕様は Issue 本文の
「詳細設計」セクション(古い Issue では `Detailed design`)。会話は日��語を基本とし、コード、
コミット、PR の文章は下の規約に従って書く。
## プロジェクトのグラウンドルール(すべての行の枠)
1. **ローカルオンリー**:Claude / Cursor / Codex 由来のデータを外に出さない。追加の通信は
AGENTS.md のオーナー承認済み例外に限る(配布ビルドの Crashlytics、オプトイン Analytics を含む)。
2. **ゼロセットアップの維持**:ユー���ーに Claude Code の設定やフックの導入を求めない。
3. **retok は無改変で同梱**:同梱の retok をこの場で編集しない。ラ��センスとクレジットを維持する。
4. **python3 は任意**:python3 が無くても Claude のコスト分析が緩やかに縮退する状態を保つ。
5. **Swift 6 / SwiftUI / macOS 14+**:`swift build` は常に緑を保つ。��規パッケージは原則禁止で、
例外は `firebase-ios-sdk`(Analytics / Crashlytics のみ)に限る。
## 進め方
### 1. Issue を特定する
Issue 番号(`#5`、`5`)でもタイトルの断片でも受け付ける。まず全文を取得する。
```bash
gh issue view <number> --repo Tokfuel/Tokfuel --json number,title,body,labels 2>/dev/null
```
**何よりも先に、その Issue をユーザーに説明する**。番号とタイトル、何をなぜ提案しているのかの
平易な要約、現在の���態を伝える。すでにクローズ済みなら手を止め、本当は何をしたいのかを確認する。
### 2. 仕様とコードで足場を作る
- Issue の「詳細設計」と、そこに書かれた代替案や制約を読む。
- Issue が参照するファイルはすべて開き、周辺コードまで読む。変更を既存の形に馴染ませるため。
大きな項目では、読む作業を `Explore` エージェントに広げ、方針は `Plan` エージェントで練る。
- 依存関係を確かめる。設計が別のオープン Issue をブロッカーとして参照しているなら、それを
表に出し、どう進めるかを確認する。
### 3. 焦点の絞れたブランチを用意する
ブランチは 1 トピックにつき 1 本。`main` 上にいるなら最新の origin から切る:
`git fetch origin && git switch -c claude/<slug> origin/main`。触るのはこの Issue に必要な
ファイルだけ。設計上どうしても横断的な変更になるなら、先にそう宣言する。
### 4. 計画を立て、書く前に確認を取る
Issue 1 件の実装は大きく、巻き戻しにくい。だから具体的な計画にユーザーの同意を得てから書く
(`EnterPlanMode` の利用