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

scaffold skill: 'adk is the only template' framing hides that -a/--agent supports third-party add-on templates

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#86 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

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
92/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ệ
python
Lĩnh vực
cli, documentation

Hướng nghiên cứu

Đọc skills/google-agents-cli-scaffold/SKILL.md và references/flags.md, sau đó kiểm tra scaffold/utils/remote_template.py, đặc biệt là parse_agent_spec, để xác nhận cú pháp Git remote. Hoàn tất khi cả hai tài liệu skill đều giải thích rằng --agent có thể xếp một add-on của vendor hoặc cộng đồng lên trên template cơ sở adk, bao gồm ví dụ được cung cấp và trỏ đến cú pháp flag đầy đủ.

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

Mô tả

documentation needs review

Is your feature request related to a problem? Please describe.

--agent/-a on scaffold create already accepts a remote Git spec (org/repo/path@ref) that layers a third-party add-on's manifest and starter files over the adk base template (scaffold/utils/remote_template.py's parse_agent_spec). This is documented generically in references/flags.md ("or remote Git URL"), but the google-agents-cli-scaffold skill's "adk is the only template" framing gives no indication the mechanism exists or how it'd be used for a real integration. A coding agent following the skill today would never discover or suggest it, even though it works correctly.

I ship one of these myself (a Keel resilience add-on for ADK agents: MisterTK/keel/packaging/agents-cli-template), and only found the CLI still supported this cleanly by reading the source, not the skill.

Describe the solution you'd like

I'd tried opening a PR with the exact doc change, but pull requests appear to be disabled on this repo, so posting the proposed diff here instead in case it's useful to apply directly.

In skills/google-agents-cli-scaffold/SKILL.md, right after the existing "adk is the only template" blockquote:

### Layering a Vendor/Community Add-on

`--agent`/`-a` also accepts a remote Git spec (`org/repo/path@ref`) that layers a
vendor or community add-on's manifest and starter files over the `adk` base
template — a separate mechanism from the architecture choice above, and the
way a third-party library ships opinionated scaffolding (extra dependencies,
starter config) without agents-cli needing to know about it in advance.
Example: `keelrun` (zero-code retry/timeout/breaker/cache policy for ADK
agents) ships one:

\`\`\`bash
agents-cli scaffold create my-agent -a MisterTK/keel/packaging/agents-cli-template
\`\`\`

See `references/flags.md`'s `--agent` row for the full spec syntax.

And in skills/google-agents-cli-scaffold/references/flags.md, the --agent row's description gains one clause: ... or remote Git URL (org/repo/path@ref— also used to layer a vendor/community add-on's manifest + starter files over a base template, e.g.MisterTK/keel/packaging/agents-cli-template).

Describe alternatives you've considered

Leaving it undocumented — but that means the mechanism stays effectively invisible to anyone (human or coding agent) relying on the skill rather than reading the CLI's own source.

Ngôn ngữ chính
Python
Star
6k
Fork
686
Không có pull request nào được merge trong 30 ngày

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 google/agents-cli

Tất cả issue của google/agents-cli

Issue tương tự

Thêm issue về Python

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.