In-app coordinator/Ralph never reads .squad/ralph-instructions.md; only `squad watch --execute` does
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 78/100
- Loại issue
- Lỗi
- Độ rõ ràng
- Đặc tả rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- github, typescript
- Lĩnh vực
- developer-experience, tooling
Hướng nghiên cứu
Đọc .github/agents/squad.agent.md và .squad/templates/ralph-reference.md, rồi so sánh các chỉ dẫn trong đó với hành vi được mô tả cho squad watch --execute. Cập nhật chỉ dẫn điều phối Ralph để tải .squad/ralph-instructions.md khi tệp này tồn tại, đồng thời sửa tham chiếu đến chính nó trong tệp tham chiếu. Hoàn tất khi các luồng điều phối trong ứng dụng làm theo chỉ dẫn do người dùng sở hữu và chuỗi tham chiếu trỏ đến tệp dự kiến.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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).
- Ngôn ngữ chính
- TypeScript
- Star
- 3.4k
- Fork
- 516
- Merge trung bình
- 1 ngày 15 giờ
- Pull request đã merge (30 ngày)
- 116
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của github/squad
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
bot:ai-assisted component:platform-js status:untriaged
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 74/100
midnightntwrk/platform-js#38 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
ranxianglei/billion-context#7068 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
vendor: bump whisper.cpp past 6a8addd — the current pin aborts the app on a failed Metal initĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
mybigday/whisper.rn#348 ·
-
enhancement severity:low
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
Battle-Cattle/BCUK-Bot-4#1075 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
ilan-pinto/roaring-lions#1552 ·
Maintainer thường phản hồi trong vòng 1 ngày