@tyhld/conductor 0.12.152 → 0.12.154
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 +5 -2
- package/dist/view-stream.js +59 -31
- package/dist/view.js +49 -25
- package/package.json +1 -1
- package/skills/conductor-craftsman/SKILL.md +18 -7
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/dist/view-stream.js
CHANGED
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
import { closeSync, existsSync, openSync, readSync, statSync } from 'node:fs';
|
|
31
31
|
import os from 'node:os';
|
|
32
32
|
import { extractProgressLine, loadActiveJob, loadLastJob, maskSecrets, } from './headless.js';
|
|
33
|
-
import { DETAIL_LINE_CHARS_MAX, LAST_OUTCOME_LABEL, STATUS_LABEL, STATUS_NOTE, collectSiteView, friendlyDuration, friendlyTime, hhmm, jobTitleFromBody, quietActivityNote, rawLogPath, } from './view.js';
|
|
33
|
+
import { DETAIL_LINE_CHARS_MAX, LAST_OUTCOME_LABEL, NO_JOB, STATUS_LABEL, STATUS_NOTE, collectSiteView, friendlyDuration, friendlyTime, hhmm, jobTitleFromBody, quietActivityNote, rawLogPath, relayRunningForSite, } from './view.js';
|
|
34
34
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
35
35
|
// 定数(★線引きはここ1か所)
|
|
36
36
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
@@ -495,34 +495,7 @@ export class FollowSession {
|
|
|
495
495
|
const nowMs = this.now();
|
|
496
496
|
if (this.deps.header !== undefined)
|
|
497
497
|
return this.deps.header(this.deps.site, nowMs);
|
|
498
|
-
|
|
499
|
-
const unknown = '—(確かめられません)';
|
|
500
|
-
const body = v.active?.body ?? v.last?.body ?? '';
|
|
501
|
-
const headline = jobHeadline(body);
|
|
502
|
-
const lines = [];
|
|
503
|
-
lines.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
504
|
-
lines.push(`仕事:${headline.length > 0 ? headline : unknown}`);
|
|
505
|
-
if (v.postedAt !== null)
|
|
506
|
-
lines.push(`投函:${friendlyTime(v.postedAt, nowMs)}`);
|
|
507
|
-
lines.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, nowMs) : '—(まだ起動していません)'}`);
|
|
508
|
-
if (v.startedAt !== null) {
|
|
509
|
-
const until = v.status === 'working' ? nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? nowMs);
|
|
510
|
-
lines.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
511
|
-
}
|
|
512
|
-
const sinceActivityMs = v.lastActivityAt === null ? null : nowMs - v.lastActivityAt;
|
|
513
|
-
if (v.lastActivityAt !== null) {
|
|
514
|
-
lines.push(`最後に動いた:${friendlyTime(v.lastActivityAt, nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`);
|
|
515
|
-
}
|
|
516
|
-
if (v.status === 'working') {
|
|
517
|
-
const note = quietActivityNote(sinceActivityMs);
|
|
518
|
-
if (note !== null)
|
|
519
|
-
lines.push(`※${note}`);
|
|
520
|
-
}
|
|
521
|
-
lines.push('');
|
|
522
|
-
lines.push('※見るだけの画面です(職人へは何も送りません/職人も作業部屋も見守り役も起動しません)');
|
|
523
|
-
lines.push('※開いたままにしておくと、下へ流れ続けます。閉じるときは Ctrl+C を押してください');
|
|
524
|
-
lines.push(RULE);
|
|
525
|
-
return lines.join('\n');
|
|
498
|
+
return renderFollowHeader(collectSiteView(this.deps.site, nowMs));
|
|
526
499
|
}
|
|
527
500
|
/** この便を追い始める。 */
|
|
528
501
|
beginFollow(active, opts) {
|
|
@@ -700,15 +673,70 @@ export class FollowSession {
|
|
|
700
673
|
}
|
|
701
674
|
this.out(RULE);
|
|
702
675
|
}
|
|
703
|
-
/**
|
|
676
|
+
/**
|
|
677
|
+
* 便が無いときの知らせ(★1回だけ出して、そのまま待つ)。
|
|
678
|
+
* ★見守り役が止まっているときは「次の便を待っています」と言わない
|
|
679
|
+
* (上の行の 💤 PC停止中 と食い違うため)。
|
|
680
|
+
*/
|
|
704
681
|
noteWaiting() {
|
|
705
682
|
if (this.waitingNoted)
|
|
706
683
|
return;
|
|
707
684
|
this.waitingNoted = true;
|
|
708
|
-
this.
|
|
685
|
+
if ((this.deps.relayRunning ?? relayRunningForSite)(this.deps.site) === false) {
|
|
686
|
+
this.out(`${STATUS_LABEL.pc_down}(${STATUS_NOTE.pc_down})`);
|
|
687
|
+
this.out('※見守り役が動き出せば、次の便が始まったときに自動で流れ始めます');
|
|
688
|
+
return;
|
|
689
|
+
}
|
|
690
|
+
this.out(`${STATUS_LABEL.idle}(いまは便がありません。次の便を待っています)`);
|
|
709
691
|
this.out('※このまま開いておけば、次の便が始まったときに自動で流れ始めます');
|
|
710
692
|
}
|
|
711
693
|
}
|
|
694
|
+
/**
|
|
695
|
+
* 流れ続ける画面の見出し(★手元の事実だけから作る純粋関数)。
|
|
696
|
+
*
|
|
697
|
+
* ★下の流れと食い違わせない(便 a5d66c34)。いま動いている便が無いときは
|
|
698
|
+
* 「仕事:なし」とし、開始・実作業・最後に動いた は出さない(直前の仕事の値で埋めると、
|
|
699
|
+
* いま動いているように読める)。直前の仕事は「直前の仕事:…(結果)」の1行で分けて出す。
|
|
700
|
+
* ★「—(確かめられません)」は、便は在るのに題名が読めないときだけに使う。
|
|
701
|
+
*/
|
|
702
|
+
export function renderFollowHeader(v) {
|
|
703
|
+
const nowMs = v.nowMs;
|
|
704
|
+
const unknown = '—(確かめられません)';
|
|
705
|
+
const lines = [];
|
|
706
|
+
lines.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
707
|
+
if (v.active === null) {
|
|
708
|
+
lines.push(`仕事:${NO_JOB}`);
|
|
709
|
+
if (v.last !== null) {
|
|
710
|
+
const prev = jobHeadline(v.last.body);
|
|
711
|
+
lines.push(`直前の仕事:${prev.length > 0 ? prev : unknown}(${LAST_OUTCOME_LABEL[v.last.outcome] ?? v.last.outcome}・${friendlyTime(v.last.finishedAt, nowMs)})`);
|
|
712
|
+
}
|
|
713
|
+
}
|
|
714
|
+
else {
|
|
715
|
+
const headline = jobHeadline(v.active.body);
|
|
716
|
+
lines.push(`仕事:${headline.length > 0 ? headline : unknown}`);
|
|
717
|
+
if (v.postedAt !== null)
|
|
718
|
+
lines.push(`投函:${friendlyTime(v.postedAt, nowMs)}`);
|
|
719
|
+
lines.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, nowMs) : '—(まだ起動していません)'}`);
|
|
720
|
+
if (v.startedAt !== null) {
|
|
721
|
+
const until = v.status === 'working' ? nowMs : (v.lastActivityAt ?? nowMs);
|
|
722
|
+
lines.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
723
|
+
}
|
|
724
|
+
const sinceActivityMs = v.lastActivityAt === null ? null : nowMs - v.lastActivityAt;
|
|
725
|
+
if (v.lastActivityAt !== null) {
|
|
726
|
+
lines.push(`最後に動いた:${friendlyTime(v.lastActivityAt, nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`);
|
|
727
|
+
}
|
|
728
|
+
if (v.status === 'working') {
|
|
729
|
+
const note = quietActivityNote(sinceActivityMs);
|
|
730
|
+
if (note !== null)
|
|
731
|
+
lines.push(`※${note}`);
|
|
732
|
+
}
|
|
733
|
+
}
|
|
734
|
+
lines.push('');
|
|
735
|
+
lines.push('※見るだけの画面です(職人へは何も送りません/職人も作業部屋も見守り役も起動しません)');
|
|
736
|
+
lines.push('※開いたままにしておくと、下へ流れ続けます。閉じるときは Ctrl+C を押してください');
|
|
737
|
+
lines.push(RULE);
|
|
738
|
+
return lines.join('\n');
|
|
739
|
+
}
|
|
712
740
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
713
741
|
// 入口(view.ts が呼ぶ)
|
|
714
742
|
// ─────────────────────────────────────────────────────────────────────────────
|
package/dist/view.js
CHANGED
|
@@ -57,6 +57,7 @@ export const DETAIL_LINE_CHARS_MAX = 600;
|
|
|
57
57
|
export const STATUS_LABEL = {
|
|
58
58
|
working: '🟠 作業中',
|
|
59
59
|
queued: '⏳ 順番待ち',
|
|
60
|
+
idle: '⏳ 待機中',
|
|
60
61
|
pc_down: '💤 PC停止中',
|
|
61
62
|
unconfirmed: '🟡 未確認',
|
|
62
63
|
awaiting_user: '🔵 操作・確認待ち',
|
|
@@ -66,11 +67,14 @@ export const STATUS_LABEL = {
|
|
|
66
67
|
export const STATUS_NOTE = {
|
|
67
68
|
working: '職人が動いています',
|
|
68
69
|
queued: 'まだ職人を起動していません',
|
|
70
|
+
idle: 'いまは便がありません(次の便を待っています)',
|
|
69
71
|
pc_down: 'このPCの見守り役が動いていません',
|
|
70
72
|
unconfirmed: '職人は止まった/終了しました(確認前です)',
|
|
71
73
|
awaiting_user: 'えふさんの手番です',
|
|
72
74
|
done: '終わりました',
|
|
73
75
|
};
|
|
76
|
+
/** 便が無いときの「仕事」の欄(★「確かめられません」とは言わない)。 */
|
|
77
|
+
export const NO_JOB = 'なし';
|
|
74
78
|
/**
|
|
75
79
|
* 6つの状態のどれかを決める純粋関数(★「作業中」の条件を厳密にする所)。
|
|
76
80
|
*
|
|
@@ -88,7 +92,9 @@ export const STATUS_NOTE = {
|
|
|
88
92
|
* 長い試験や長い考えごとの最中に「止まった」と言わないため(便 062431f2 の直し)。
|
|
89
93
|
* c. 実プロセスが生きていて、見守り役の生死が確かめられない(null)→
|
|
90
94
|
* 手がかりは記録だけ。最近の記録があれば 🟠、無ければ 🟡。
|
|
91
|
-
* 4.
|
|
95
|
+
* 4. 実行中の仕事が無ければ、直前の仕事が done で終わっていれば ✅、
|
|
96
|
+
* 失敗などで終わっていれば 🟡(下の「結果:⚠ …」と食い違わせない)、
|
|
97
|
+
* 直前の仕事も無ければ ⏳ 待機中(★順番待ちとは言わない=上の型の注記)。
|
|
92
98
|
*/
|
|
93
99
|
export function decideSiteStatus(input) {
|
|
94
100
|
if (input.relayRunning === false)
|
|
@@ -103,9 +109,10 @@ export function decideSiteStatus(input) {
|
|
|
103
109
|
const activityFresh = input.sinceActivityMs !== null && input.sinceActivityMs <= QUIET_ACTIVITY_MS;
|
|
104
110
|
return activityFresh ? 'working' : 'unconfirmed';
|
|
105
111
|
}
|
|
106
|
-
if (input.hasLastJob)
|
|
107
|
-
return 'done';
|
|
108
|
-
|
|
112
|
+
if (input.hasLastJob) {
|
|
113
|
+
return input.lastOutcome === undefined || input.lastOutcome === 'done' ? 'done' : 'unconfirmed';
|
|
114
|
+
}
|
|
115
|
+
return 'idle';
|
|
109
116
|
}
|
|
110
117
|
/**
|
|
111
118
|
* 🟠 のまま添える注記を返す(記録が長く止まっているときだけ1行)。
|
|
@@ -345,6 +352,7 @@ export function collectSiteView(site, nowMs = Date.now()) {
|
|
|
345
352
|
sinceActivityMs: lastActivityAt === null ? null : nowMs - lastActivityAt,
|
|
346
353
|
awaitingUser,
|
|
347
354
|
hasLastJob: last !== null,
|
|
355
|
+
lastOutcome: last?.outcome,
|
|
348
356
|
});
|
|
349
357
|
const body = active?.body ?? last?.body ?? '';
|
|
350
358
|
return {
|
|
@@ -371,29 +379,18 @@ export function renderNormalView(v) {
|
|
|
371
379
|
const out = [];
|
|
372
380
|
const unknown = '—(確かめられません)';
|
|
373
381
|
out.push(`${v.site} ${STATUS_LABEL[v.status]} ${STATUS_NOTE[v.status]}`);
|
|
374
|
-
|
|
375
|
-
//
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
out.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
381
|
-
}
|
|
382
|
-
else {
|
|
382
|
+
// ★いま動いている便が無いときは「仕事:なし」。直前の仕事は下の段に出す。
|
|
383
|
+
// 開始・実作業などを直前の仕事の値で埋めると、いま動いているように読める。
|
|
384
|
+
if (v.active === null) {
|
|
385
|
+
out.push(`仕事:${NO_JOB}`);
|
|
386
|
+
out.push('投函:—');
|
|
387
|
+
out.push('開始:—');
|
|
383
388
|
out.push('実作業:—');
|
|
389
|
+
out.push('最後に動いた:—');
|
|
390
|
+
out.push('現在:—');
|
|
384
391
|
}
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
out.push(v.lastActivityAt !== null
|
|
388
|
-
? `最後に動いた:${friendlyTime(v.lastActivityAt, v.nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`
|
|
389
|
-
: `最後に動いた:${unknown}`);
|
|
390
|
-
const current = v.flow.length > 0 ? v.flow[v.flow.length - 1].text : '';
|
|
391
|
-
out.push(`現在:${current.length > 0 ? current : unknown}`);
|
|
392
|
-
// ★作業中のまま記録が長く止まっているときは、理由の候補を1行添える(状態は変えない)。
|
|
393
|
-
if (v.status === 'working') {
|
|
394
|
-
const note = quietActivityNote(sinceActivityMs);
|
|
395
|
-
if (note !== null)
|
|
396
|
-
out.push(`※${note}`);
|
|
392
|
+
else {
|
|
393
|
+
pushActiveFacts(out, v, unknown);
|
|
397
394
|
}
|
|
398
395
|
out.push(RULE);
|
|
399
396
|
if (v.flow.length > 0) {
|
|
@@ -427,6 +424,33 @@ export function renderNormalView(v) {
|
|
|
427
424
|
out.push('※Claude Code の生ログを見たいときは --detail を付けてください');
|
|
428
425
|
return out.join('\n');
|
|
429
426
|
}
|
|
427
|
+
/** いま動いている便の「仕事・投函・開始・実作業・最後に動いた・現在」の行。 */
|
|
428
|
+
function pushActiveFacts(out, v, unknown) {
|
|
429
|
+
out.push(`仕事:${v.title.length > 0 ? v.title : unknown}`);
|
|
430
|
+
// ★投函・開始・実作業を別々に出す(えふさん確定③)。
|
|
431
|
+
out.push(`投函:${v.postedAt !== null ? friendlyTime(v.postedAt, v.nowMs) : '—(管制が持っています)'}`);
|
|
432
|
+
out.push(`開始:${v.startedAt !== null ? friendlyTime(v.startedAt, v.nowMs) : '—(まだ起動していません)'}`);
|
|
433
|
+
if (v.startedAt !== null) {
|
|
434
|
+
const until = v.status === 'working' ? v.nowMs : (v.lastActivityAt ?? v.last?.finishedAt ?? v.nowMs);
|
|
435
|
+
out.push(`実作業:${friendlyDuration(until - v.startedAt)}`);
|
|
436
|
+
}
|
|
437
|
+
else {
|
|
438
|
+
out.push('実作業:—');
|
|
439
|
+
}
|
|
440
|
+
// ★「いつ」だけでなく「どれだけ前か」も出す(止まっている時間が一目で分かる)。
|
|
441
|
+
const sinceActivityMs = v.lastActivityAt === null ? null : v.nowMs - v.lastActivityAt;
|
|
442
|
+
out.push(v.lastActivityAt !== null
|
|
443
|
+
? `最後に動いた:${friendlyTime(v.lastActivityAt, v.nowMs)}(${friendlyDuration(sinceActivityMs ?? 0)}前)`
|
|
444
|
+
: `最後に動いた:${unknown}`);
|
|
445
|
+
const current = v.flow.length > 0 ? v.flow[v.flow.length - 1].text : '';
|
|
446
|
+
out.push(`現在:${current.length > 0 ? current : unknown}`);
|
|
447
|
+
// ★作業中のまま記録が長く止まっているときは、理由の候補を1行添える(状態は変えない)。
|
|
448
|
+
if (v.status === 'working') {
|
|
449
|
+
const note = quietActivityNote(sinceActivityMs);
|
|
450
|
+
if (note !== null)
|
|
451
|
+
out.push(`※${note}`);
|
|
452
|
+
}
|
|
453
|
+
}
|
|
430
454
|
/** 直前の仕事の終わり方の日本語。 */
|
|
431
455
|
export const LAST_OUTCOME_LABEL = {
|
|
432
456
|
done: '✅ 終わりました',
|
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)。
|