Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

[awf-feature-surfacing] Surface model-routing and governance toolset guidance

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#68,542 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
68/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu từ câu diễn đạt đã lỗi thời ở dòng 97 của .github/aw/syntax-engine.md và đối chiếu với docs/src/content/docs/reference/model-routing.md, tệp này đã nêu đúng các quy tắc. Sau đó thêm phần quản trị vào danh sách Available ở dòng 22 của docs/src/content/docs/reference/github-tools.md, dùng pkg/workflow/data/github_toolsets_permissions.json để lấy mục đích của công cụ và quyền của token. Công việc hoàn tất khi cả hai trang khớp với schema và bản đồ quyền đó.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

automation awf compiler specifications
Overview

The seven-day AWF spec/compiler review found two user-facing guidance gaps in recently changed capabilities. The compiler and schema accept the behavior, but two discoverable syntax references still give incomplete or incorrect instructions.

Key findings
  • P2 — Model routing syntax: .github/aw/syntax-engine.md says engine.model-routing.allowed-models is required and implies it limits models the routed task may call. Since #68495, it is an optional router candidate list (AWF v0.28.33+); only models.allowed and models.blocked set the request policy. The same syntax entry omits the engine.model-provider: github requirement for routed Claude and Codex workflows enforced by #68080.
  • P2 — GitHub governance toolset: The tools.github.toolsets schema accepts governance after #67738, and .github/aw/syntax-tools-imports.md lists it, but the Available list in docs/src/content/docs/reference/github-tools.md omits it. The reference also lacks a short explanation of its custom property and ruleset tools and token permissions.
Evidence and current surfacing
  • pkg/parser/schemas/main_workflow_schema.json has engine.model-routing required fields goal and mode only, and describes allowed-models as optional router candidates. It includes governance in github_toolset_name.
  • pkg/workflow/model_routing.go applies routing policy and provider validation; pkg/workflow/data/github_toolsets_permissions.json maps governance to custom property and ruleset tools and their permission needs.
  • docs/src/content/docs/reference/model-routing.md correctly explains optional candidates, the AWF version boundary, request policy, and the GitHub provider requirement. docs/src/content/docs/reference/frontmatter.md also describes the candidate/policy distinction.
  • .github/aw/syntax-engine.md:97 retains the stale required-field and request-limit wording. docs/src/content/docs/reference/github-tools.md:22 has the incomplete toolset list.
  • Relevant changes: #68495 (63e2c65) and #68080 (70f8448) for routing; #67738 for GitHub MCP toolsets.
Next actions
  • P2: Update .github/aw/syntax-engine.md to call allowed-models optional for AWF v0.28.33+, describe it as router candidates only, and point readers to models.allowed / models.blocked for request policy. State that routed Claude and Codex must resolve engine.model-provider to github.
  • P2: Update the GitHub tools reference's available-toolsets list and add a compact governance example with the tool purposes and required token permissions, using the permission map as the source.

Generated by 🧭 Daily AWF Spec Compiler Surfacing Review · codex · gpt60 · 127.8 AIC · ⌖ 5.96 AIC · ⊞ 14.1K · ◷

  • expires on Oct 20, 2026, 2:27 PM UTC-08:00
Ngôn ngữ chính
Go
Star
5.4k
Fork
584
Merge trung bình
3 giờ 59 phút
Pull request đã merge (30 ngày)
823

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

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/gh-aw

Tất cả issue của github/gh-aw

Issue tương tự

Thêm issue về Go

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.