github / github/copilot-cli

Support configurable user-level discovery paths for agents, skills, hooks, and instructions

Đang mở
#4,622 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.

area:agents area:configuration area:plugins
Ngôn ngữ chính
Shell
Star
11.2k
Fork
1.9k
Merge trung bình
14 giờ 16 phút
Pull request đã merge (30 ngày)
6

Mô tả

Copilot CLI currently discovers shared user-level artifacts from fixed locations such as:

%USERPROFILE%\.agents

This is useful as a cross-tool default, but there is no supported way to relocate that discovery root for managed or XDG-style profile layouts.

COPILOT_CUSTOM_INSTRUCTIONS_DIRS only adds instruction directories. It does not provide equivalent discovery overrides for:

  • Agents
  • Skills
  • Hooks
  • Shared manifests or related metadata

COPILOT_HOME is not an appropriate substitute because it relocates broader Copilot application state, including sessions, databases, packages, caches, and lock files.

Requested behavior

Provide one or more documented environment variables or configuration settings for additional user-level discovery roots.

For example:

COPILOT_AGENT_DIRS
COPILOT_SKILL_DIRS
COPILOT_HOOK_DIRS
COPILOT_CUSTOM_INSTRUCTIONS_DIRS

Alternatively, support a unified root:

COPILOT_USER_CONFIG_DIR=C:\Users\<user>\.config\agents

with documented subdirectories:

agents\
skills\
hooks\
instructions\

Compatibility

The existing %USERPROFILE%\.agents location should remain a default discovery path. Configured paths should augment or override it through clearly documented precedence rules.

This would preserve the .agents interoperability convention while allowing:

  • Enterprise-managed profile layouts
  • XDG-style configuration separation
  • Portable development environments
  • Machines where the profile root should remain free of tool-owned directories

Related issues

This request is complementary to #4204: that issue proposes broader .agents discovery, while this issue requests a supported way to configure where that user-level discovery tree lives.

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

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.

Hướng nghiên cứu

Không có tệp nguồn hoặc bài kiểm thử nào được nêu tên. Trước tiên, hãy xác định cơ chế khám phá hiện có ở cấp người dùng cho %USERPROFILE%.agents và COPILOT_CUSTOM_INSTRUCTIONS_DIRS, sau đó xác định cách biểu diễn các thư mục gốc có thể cấu hình và thứ tự ưu tiên. Được xem là hoàn thành khi các thiết lập đã được ghi lại hỗ trợ các loại artifact được yêu cầu mà vẫn giữ nguyên đường dẫn mặc định hiện có.

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

Đánh giá

Công nghệ
shell
Lĩnh vực
cli
Loại issue
Tính năng
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Sôi nổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
45/100

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.