Proposal: Portable C++ Core Guidelines Agent Skill with rule-linked evaluations

Đang mở
#2,342 2 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
cpp, github
Lĩnh vực
ai, documentation

Hướng nghiên cứu

Start with the repository’s existing tool support and automatic processing, then review the C++ Core Guidelines source and the Agent Skills specification linked in the issue. The proposal needs a decision on whether the package belongs here or in a companion project, plus scope and maintenance expectations. Done would include an agreed pilot covering 10–20 rules and a plan for rule-linked evaluations, synchronization, and reporting.

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

Mô tả

Would the project be open to a portable Agent Skills package derived from the C++ Core Guidelines, accompanied by a vendor-neutral evaluation suite?

The goal would be to help coding agents apply and cite relevant guidelines during implementation and review across compatible development tools. This seems aligned with the project's existing emphasis on tool support and automatic processing.

Proposed approach
  • Keep the existing guidelines as the authoritative source. Generate indexed reference material preserving rule IDs, explanations, exceptions, links, and license attribution, and record the source commit.
  • Provide a concise SKILL.md that guides an agent to inspect the project's C++ version and constraints, load relevant rules on demand, explain findings with rule references, and validate changes using available compiler checks, tests, and static analysis.
  • Document client compatibility and tool prerequisites. Reuse existing checks, including applicable clang-tidy checks.
  • Distinguish reference coverage from evaluated coverage: making the whole document accessible would not imply that every rule can be automatically enforced or has been validated.
Shared evaluations

Publish evaluation cases and expected outcomes independently of any particular model or agent runner. Cases should cover:

  • Genuine violations and correct rule attribution.
  • Compliant code that should not be flagged or changed.
  • Documented exceptions and project-specific constraints.
  • Fixes that compile, pass relevant tests, and preserve intended behavior.
  • Situations where additional context is needed before making a recommendation.

For example, ownership tests should distinguish a raw owning pointer from a legitimate non-owning raw pointer, rather than rewarding blanket replacement with smart pointers.

Compare the same agent with and without the skill, record model/tool versions, and report results per rule, including missed violations, false positives, and incorrect edits. Use held-out cases beyond the examples embedded in the guidelines, with compiler/test checks and human-reviewed expectations where applicable.

Initial scope and maintenance

A first pilot could evaluate 10–20 rules around resource management, ownership, and lifetime. Broader evaluation coverage could grow incrementally based on evidence and review.

Would this be appropriate for this repository, or better maintained as a linked companion project? Feedback on pilot scope, synchronization with upstream changes, and maintenance expectations would help establish a manageable contribution path.

Ngôn ngữ chính
CSS
Star
45.5k
Fork
5.6k
Merge trung bình
6 phút
Pull request đã merge (30 ngày)
1

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 isocpp/CppCoreGuidelines

Tất cả issue của isocpp/CppCoreGuidelines

Issue tương tự

Thêm issue về AI Infra & Agents

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.