In-app coordinator/Ralph never reads .squad/ralph-instructions.md; only `squad watch --execute` does
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 78/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- github, typescript
調査の方向性
.github/agents/squad.agent.md と .squad/templates/ralph-reference.md を読み、squad watch --execute について説明されている動作と、それぞれの指示を比較してください。Ralph のディスパッチ指示を更新し、.squad/ralph-instructions.md が存在する場合は読み込むようにしてください。また、参照ファイル内の自己参照を修正してください。アプリ内のディスパッチ経路がユーザー所有の指示に従い、参照チェーンが意図したファイルを指すようになれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Problem
.squad/ralph-instructions.md is the user-owned file for Ralph's repo rules. Its own header says squad init creates it and squad upgrade never overwrites it. But only squad watch --execute tells the spawned session to read it.
The in-app path never mentions the file. "Ralph, go" and coordinator-driven issue dispatch run from .github/agents/squad.agent.md (coordinator v1.0.1) and its on-demand .squad/templates/ralph-reference.md, and neither references .squad/ralph-instructions.md. So any rule a user writes there is skipped whenever the coordinator, rather than watch --execute, dispatches issue work.
Observed with squad-cli 1.0.1 on Windows:
- The repo's
ralph-instructions.mddefines a multi-host claim protocol: assign the issue, comment "Claimed by ", and run an election over the issue timeline. - An in-app coordinator session dispatched about 10 issue sessions without claiming any of them.
- Two issues were worked twice by the same coordinator across context windows, which a claim check would have prevented.
- Other rules in that file are skipped too, including host concurrency limits and the round-report format.
.squad/templates/ralph-reference.md line 11 also points to itself ("Read .squad/templates/ralph-reference.md…"), so the reference chain ends there.
Expected
Every Ralph/coordinator work-dispatch path loads .squad/ralph-instructions.md when it exists, with the same precedence watch --execute gives it. That way the user-owned rules apply no matter how work is dispatched.
Suggested fix
- In
squad.agent.md, in the Ralph section and before any issue dispatch: "If{TEAM_ROOT}/.squad/ralph-instructions.mdexists, read it and follow it before selecting or dispatching issue work." - Fix the self-reference in
templates/ralph-reference.md. - Optionally, have the coordinator load it once per session alongside
team.md/routing.md.
Workaround
Add a pointer in .github/copilot-instructions.md, which squad upgrade does not manage.
Related: #1314 (documenting the escape hatch).
- 主要言語
- TypeScript
- スター
- 3.4k
- フォーク
- 516
- 平均マージ
- 1日 15時間
- マージ済み PR(30日)
- 116
環境構築
- Dockerfile または Docker Compose ファイルあり
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
github/squad のほかの issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
bot:ai-assisted component:platform-js status:untriaged
難易度 1/5 1時間未満 初心者へのやさしさ 74/100
midnightntwrk/platform-js#38 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
ranxianglei/billion-context#7068 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
mybigday/whisper.rn#348 ·
-
enhancement severity:low
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
Battle-Cattle/BCUK-Bot-4#1075 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 67/100
ilan-pinto/roaring-lions#1552 ·
メンテナーはふだん 1 日以内に返信