In-app coordinator/Ralph never reads .squad/ralph-instructions.md; only `squad watch --execute` does

Đang mở Phù hợp với người mới
#2,233 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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

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ả

wave:2-soon

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.md defines 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.md exists, 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

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/squad

Tất cả issue của github/squad

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.