@tyhld/conductor 0.12.152 → 0.12.153
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/build-prompt.js
CHANGED
|
@@ -136,11 +136,14 @@ export function buildCraftsmanPrompt(input) {
|
|
|
136
136
|
// 囲いがそこを塞いでいる機体では push が成功しても「上流の設定を書けない」で止まる。
|
|
137
137
|
'・テストが緑になってから push → プルリクエストを作成 → 合流する。合流の仕方は職人の鉄則7のとおり:',
|
|
138
138
|
' push は `git push origin <作業ブランチ名>`(★`-u` を付けない=上流の設定を書かない形)。',
|
|
139
|
-
' 保護あり(必須の検査がある)… `gh pr merge <番号> --auto --merge
|
|
139
|
+
' 保護あり(必須の検査がある)… `gh pr merge <番号> --auto --merge` で予約する。',
|
|
140
140
|
' 保護なし … ★`--auto` を先に打たない。`gh pr checks <番号>` で CI(`/actions/runs/` の行)がすべて pass なのを',
|
|
141
|
-
' 確かめてから `gh pr merge <番号> --merge
|
|
141
|
+
' 確かめてから `gh pr merge <番号> --merge`。Vercel だけの緑は CI の緑と数えない。',
|
|
142
142
|
' CI が無い … 「確認は要らない」とは読まない。リポに在る検査を手元で流して成功を確かめてから合流する。',
|
|
143
143
|
' 流せない・失敗した・どれを流すか分からないときは、合流せず outcome=blocked で止める。',
|
|
144
|
+
// ★`--delete-branch` は手元の作業場所を古い main へ切り替えて止まる(便 613837fd・えふさん決定 2026-10-26)。
|
|
145
|
+
' ★`--delete-branch` は付けない。MERGED・合流先・合流のコミットが origin に在るのを確かめた後に、',
|
|
146
|
+
' `gh api -X DELETE repos/<owner>/<repo>/git/refs/heads/<作業ブランチ名>` で GitHub 上の枝だけを消す(手元の枝は触らない)。',
|
|
144
147
|
'・★確認できない・赤・実行中のときは合流しない。',
|
|
145
148
|
'・★`--admin` など保護を迂回する旗は使わない。保護が理由で合流できないときは、回避せず報告して止まる。',
|
|
146
149
|
'・報告は簡潔に(変更したファイル・要点・確かめた結果)。専門用語はできるだけ避ける。',
|
package/package.json
CHANGED
|
@@ -17,6 +17,8 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
17
17
|
## 鉄則15項
|
|
18
18
|
|
|
19
19
|
1. **着手時の確認と枝分かれ** — `git status && git log --oneline -3 && git stash list` を確認してから main を最新化し、新ブランチを切る。
|
|
20
|
+
- ★**枝は最新の `origin/main` から切る(手元の `main` から切らない・えふさん決定 2026-10-26)。** `git fetch origin` を1回打ち、`git switch -c <作業ブランチ名> --no-track origin/main`(鉄則7-⓪の形)。手元の `main` は古いまま置かれていることがある(実地 便 613837fd:275件遅れ)ので、そこから切ると古い土台の上で作業することになる。
|
|
21
|
+
- ★**手元の作業場所で枝を切り替えられないとき**(はじめから在る変更が切り替えとぶつかる等)は、`git worktree add -b <作業ブランチ名> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` で**別の作業場所**を作り、以後はそこで作業する(cd はその作業場所へ1回だけ=鉄則2)。終わったら `git worktree remove /tmp/claude-1000/<便IDを入れた名前>` で片付ける。★はじめから在る変更を退避(stash)・強制(`-f`・`--force`)・上書きして切り替えない(実地 便 934fca62 → dd5fe11a)。★これは便の作業場所の話で、空振り確認には worktree を使わない(鉄則13)。
|
|
20
22
|
- ★**リポ全体の差分が「読めないファイル」で落ちたとき**(`unsupported file type` / `cannot hash <名前>` が出る/`.npmrc` のような設定が身に覚えなく `M` で出る)。**これは壊れていない。**
|
|
21
23
|
秘密に分類されたファイルは職人から中身を隠してあるので、git がそのファイルを数えられないだけ。**中身を見に行く方へ回らない。**
|
|
22
24
|
- ① そのファイルを**触らない・開かない・`git diff` の対象にしない**。「読めるようにする」方向へ回避しない(鉄則4)。
|
|
@@ -30,13 +32,13 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
30
32
|
5. **エージェント設定に書き込まない** — `.mcp.json`、`.claude/` 配下、hooks 等のエージェント設定パスには書き込まない。
|
|
31
33
|
6. **本番に触らない** — 本番DB・deploy・secret に触らない。SQL/DDL は作って提示のみ(適用は人間)。
|
|
32
34
|
7. **便の終点はマージまで(★保護を迂回しない)** — push → PR作成 → 合流する。★push は**上流の設定を書かない形**で打つ(⓪)。★合流の仕方は、そのリポの合流先に**保護(必須の検査)**があるかで分ける。リポの名前は覚えなくてよい。
|
|
33
|
-
- ⓪ **上流の設定を書かない形で push する**=`git push origin <作業ブランチ名>`。★`-u`(`--set-upstream`)を付けない。`-u` と `git checkout -b <枝> origin/main` は `.git/config` へ書き込むので、囲いがその書き込みを塞いでいるPCでは「上流の設定を書けない」で止まる(**push 自体は成功している**ので、打ち直すと食い違って見える=実測 便 2cb1adf6・ef8def38)。枝を切るときも同じで `git switch -c <枝> --no-track origin/main`(または `git branch --no-track <枝> origin/main` のあと `git switch <枝>`)。★これは回避の近道ではなく**どのPCでも同じに通る形**なので、塞がれていないPC
|
|
35
|
+
- ⓪ **上流の設定を書かない形で push する**=`git push origin <作業ブランチ名>`。★`-u`(`--set-upstream`)を付けない。`-u` と `git checkout -b <枝> origin/main` は `.git/config` へ書き込むので、囲いがその書き込みを塞いでいるPCでは「上流の設定を書けない」で止まる(**push 自体は成功している**ので、打ち直すと食い違って見える=実測 便 2cb1adf6・ef8def38)。枝を切るときも同じで `git switch -c <枝> --no-track origin/main`(または `git branch --no-track <枝> origin/main` のあと `git switch <枝>`)。★これは回避の近道ではなく**どのPCでも同じに通る形**なので、塞がれていないPCでもこの形で打つ(上流の設定は職人の作業に要らない)。★切る元は `git fetch origin` のあとの**最新の `origin/main`**(手元の `main` ではない)。手元で切り替えられないときは `git worktree add -b <枝> --no-track /tmp/claude-1000/<便IDを入れた名前> origin/main` の別の作業場所で作業し、終わったら `git worktree remove` で片付ける(鉄則1)。
|
|
34
36
|
- ① **保護があるかを読む。** 合流先は `gh pr view <番号> --json baseRefName -q .baseRefName`(ふつうは main)。`gh api 'repos/{owner}/{repo}/branches/<合流先>/protection/required_status_checks' --jq '.contexts | length'` が **1 以上の数を返したときだけ「保護あり」**。0・404(Branch not protected)・403・その他の失敗は、すべて**「保護なし」**として扱う。
|
|
35
|
-
- ② **保護あり** … `gh pr merge <番号> --auto --merge
|
|
36
|
-
- 「auto-merge が使えない」と断られたときは、`gh pr checks <番号>` で必須の検査が pass なのを確かめてから `gh pr merge <番号> --merge
|
|
37
|
-
- ③ **保護なし** … ★`--auto` を先に打たない。保護の無いリポでは予約にならず、**CI を待たずにその場で合流する**(2026-09-17 に3リポで実測)。先に `gh pr checks <番号>` を見て、**そのリポで定義された CI(リンクが `/actions/runs/` の行)がすべて完了して pass** であることを確かめてから、`gh pr merge <番号> --merge
|
|
37
|
+
- ② **保護あり** … `gh pr merge <番号> --auto --merge` で**合流を予約する**。必須の検査が緑になった後に GitHub が合流する(赤のままなら合流されない)。
|
|
38
|
+
- 「auto-merge が使えない」と断られたときは、`gh pr checks <番号>` で必須の検査が pass なのを確かめてから `gh pr merge <番号> --merge`。
|
|
39
|
+
- ③ **保護なし** … ★`--auto` を先に打たない。保護の無いリポでは予約にならず、**CI を待たずにその場で合流する**(2026-09-17 に3リポで実測)。先に `gh pr checks <番号>` を見て、**そのリポで定義された CI(リンクが `/actions/runs/` の行)がすべて完了して pass** であることを確かめてから、`gh pr merge <番号> --merge`。
|
|
38
40
|
- ★Vercel の行(リンクが vercel.com)は CI ではない。**Vercel だけが緑でも、CI の緑とは数えない。**
|
|
39
|
-
- ④ **CI が無いリポ**(③の一覧に `/actions/runs/` の行が1つも無い)… ★「CI が無いから確認は要らない」とは読まない。そのリポに在る検査(試験・型確認・lint・build のうち、リポに定義されているもの)を**手元で実行して、すべて成功したことを確かめてから** `gh pr merge <番号> --merge
|
|
41
|
+
- ④ **CI が無いリポ**(③の一覧に `/actions/runs/` の行が1つも無い)… ★「CI が無いから確認は要らない」とは読まない。そのリポに在る検査(試験・型確認・lint・build のうち、リポに定義されているもの)を**手元で実行して、すべて成功したことを確かめてから** `gh pr merge <番号> --merge`。実行できない・失敗した・どれを流せばよいか分からないときは、**合流せず、人の判断待ちとして止めて報告する**。
|
|
40
42
|
- ★**確認できない・赤(fail)・実行中(pending)のときは合流しない。** 実行中なら、終わってから確かめ直す。
|
|
41
43
|
- ★**`--admin` など保護を迂回する旗は、通常運用では使わない。** branch protection は「CI が通っていない物を main に入れない」ための仕組みで、迂回すると**赤いまま本番の元が変わる**。旗を1つ付けるだけで、その現場の唯一の歯止めが外れる。
|
|
42
44
|
- ★**保護が理由で合流できないときは、回避せずそこで止めて報告する**(人の手番)。別の旗を探さない。
|
|
@@ -45,6 +47,10 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
45
47
|
- ★**合流したかの確かめ方(題名では判定しない・えふさん確定 2026-09-18)。** 合流完了の判定はコミット題名では行わない。GitHub上で対象PRが MERGED であること、merge先が意図したbase branchであること、merge後のbase branchに対象PRの変更内容が含まれることを確認する。(squash merge / merge commit / rebase merge の方式に依存しない確認にする)
|
|
46
48
|
- ★これは共通正本 `claude-code-operations.md §11.3` と、この鉄則7 の2か所を正本にする(各リポの CLAUDE.md へは複製しない)。
|
|
47
49
|
- 確かめ方の例(値は実際の番号・ブランチ名に置き換える):`gh pr view 番号 --json state,baseRefName,mergeCommit` で、`state` が `MERGED`、`baseRefName` が意図した base branch(ふつうは `main`)であることを見る。`git fetch origin` のあと `git merge-base --is-ancestor mergeCommitのoid origin/base` が成功する(=合流でできたコミットが base に含まれる)ことを見る。`gh pr diff 番号` の変更が、`git diff` や `git show origin/base:ファイル` で base branch に入っていることを、変更したファイルごとに見比べる。
|
|
50
|
+
- ★**`gh pr merge` に `--delete-branch` を付けない。合流を確かめた後に、GitHub 上の作業の枝だけを消す**(えふさん決定 2026-10-26・便 613837fd)。
|
|
51
|
+
- なぜ:`--delete-branch` は GitHub 上の枝と一緒に**手元の枝も消し、手元の作業場所を手元の `main` へ切り替える**。手元の `main` が古いまま置かれていると、作業場所が古い土台へ切り替わって止まる(実地 便 613837fd:275件遅れの `main` へ切り替わった)。
|
|
52
|
+
- 形:上の確かめ(`state` が `MERGED`・`baseRefName` が意図した base・合流のコミットが `origin/<base>` に在る)が**すべて通った後に**、枝の名前を名指しして `gh api -X DELETE repos/<owner>/<repo>/git/refs/heads/<作業ブランチ名>` を1回打つ(★変数を使わず実際の名前を書く=番人は行き先を確かめられない形を止める)。そのあと `git ls-remote --heads origin <作業ブランチ名>` が空なのを見る。`Reference does not exist` と断られたら、リポの設定で GitHub が先に消している=この `ls-remote` が空なら消えている。
|
|
53
|
+
- ★**手元の作業場所の枝の切り替え・手元の枝の削除はしない。** 合流後の確かめが1つでも落ちたら、枝は消さない(PR を直す場所が無くなる)。
|
|
48
54
|
- ★**上の4つ(保護の確認・CI・合流・合流後の確かめ)を1回で流す形**(便 03bef270)。★**確かめは1つも省いていない**:段の名前(`protect` / `ci` / `merge` / `verify`)付きで結果を出し、**落ちた段で止まる**。`--admin` は使わない。確かめを減らしたいときにこの塊を削らない。
|
|
49
55
|
そのままコピーして、1回の実行として流す(`PR=<PR番号>`)。手で1つずつ打つ従来の手順も、そのまま有効。
|
|
50
56
|
```bash
|
|
@@ -84,10 +90,10 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
84
90
|
|
|
85
91
|
# ③ 合流 … 保護あり=予約(緑になり次第 GitHub が合流)/保護なし=緑を確かめたうえで合流。
|
|
86
92
|
if [ "$PROT" = yes ]; then
|
|
87
|
-
gh pr merge "$PR" --auto --merge
|
|
93
|
+
gh pr merge "$PR" --auto --merge || ng merge '合流の予約に失敗(鉄則7-② で確かめ直す。旗を足さない)'
|
|
88
94
|
ok merge '保護あり=合流を予約した'
|
|
89
95
|
else
|
|
90
|
-
gh pr merge "$PR" --merge
|
|
96
|
+
gh pr merge "$PR" --merge || ng merge '合流に失敗'
|
|
91
97
|
ok merge '保護なし=CI の緑を確かめてから合流した'
|
|
92
98
|
fi
|
|
93
99
|
|
|
@@ -108,7 +114,12 @@ description: 采配くんの便(プロンプト末尾に CONDUCTOR_JOB:<id>
|
|
|
108
114
|
git fetch origin --quiet || ng verify 'fetch に失敗'
|
|
109
115
|
git merge-base --is-ancestor "$OID" "origin/$BASE" || ng verify "変更が origin/$BASE に入っていない"
|
|
110
116
|
ok verify "MERGED / base=$BASE / $OID が origin/$BASE に入っている"
|
|
117
|
+
# ★GitHub 上の作業の枝は、この塊の中では消さない(変数の行き先は番人が止める)。4段が通った後に、
|
|
118
|
+
# 下に出る1行を枝の名前を名指ししたまま1回打つ。手元の枝の切り替え・削除はしない。
|
|
119
|
+
HEAD_REF="$(V headRefName .headRefName)"
|
|
120
|
+
[ -z "$HEAD_REF" ] || printf '次の1回(GitHub 上の作業の枝だけを消す): gh api -X DELETE repos/%s/git/refs/heads/%s\n' "$SLUG" "$HEAD_REF"
|
|
111
121
|
```
|
|
122
|
+
★塊の後に、出た1行(`gh api -X DELETE repos/<owner>/<repo>/git/refs/heads/<作業ブランチ名>`)を**実際の名前のまま**1回打ち、`git ls-remote --heads origin <作業ブランチ名>` が空なのを見る(上の「`--delete-branch` を付けない」の項)。★`verify` が落ちたときは、この1行は出ないので枝は消さない。
|
|
112
123
|
8. **ブラウザ検品(Playwright)の作法** — ★取りに行かない。PCに1回だけ入れた共有の道具を指すだけ(ADR-010)。
|
|
113
124
|
- ① **起動は必ず `chromium_sandbox=False`**(`--no-sandbox`)。付けないと起動できない。
|
|
114
125
|
- ② **道具は共有の場所を使う。自分でダウンロードしない。** python は `$HOME/.tyhld/pw-venv/bin/python`、`PLAYWRIGHT_BROWSERS_PATH` は `$HOME/.tyhld/pw-browsers`。**無ければそこで止めて「人の手番=`APPLY=1 bash scripts/pw-browser-install.sh`」と報告する。** `playwright install` も `pip install playwright` も職人は実行しない(毎便まるごとダウンロードが走り、便が遅くなる。通信自体は鉄則12のとおり許可済みだが、取りに行かないのが本筋=ADR-010)。
|