Proposal: Portable C++ Core Guidelines Agent Skill with rule-linked evaluations
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.mdthat 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-tidychecks. - 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
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- 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.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của isocpp/CppCoreGuidelines
-
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 78/100
isocpp/CppCoreGuidelines#2345 ·
-
NL.16 is ambiguousĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
isocpp/CppCoreGuidelines#2344 · 3 bình luận ·
-
Use short #s-xxx as ref, not long like #sl-the-standard-library or #gsl-guidelines-support-libraryĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100
isocpp/CppCoreGuidelines#2340 ·
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
isocpp/CppCoreGuidelines#2205 · 8 bình luận ·
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 64/100
isocpp/CppCoreGuidelines#1649 · 3 bình luận ·
Tất cả issue của isocpp/CppCoreGuidelines
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
blinkospace/blinko#1287 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Add an LLM provider presetĐang mởarea: daemon enhancement good first issue help wanted
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 79/100
Maintainer thường phản hồi trong vòng 1 ngày
-
priority:high ready-for-dev
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
OpenHands/software-agent-sdk#6942 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement ready
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 86/100
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
obra/superpowers#2714 ·
Maintainer thường phản hồi trong vòng 5 ngày