Periodic judgment sweep for doc drift a check can't catch (files issues, no edits)

Đang mở
  • Có gì không ổn?
#7,628 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ó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
68/100
Loại issue
Tính năng
Độ 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
devtools, documentation

Hướng nghiên cứu

Read #7624 and #7617 first to understand the existing audit and parallel read-only approach. Compare the procedures in .claude/skills, .claude/rules, .claude/agents and docs/agents with the workflows and tools, then check README and docs/validation.md claims against cited evidence and dates. Document the doc groups, comparison list, and issue format in a skill or docs/agents/ page; done when the first run files findings with both sides and file:line references.

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

Mô tả

documentation

Part of #7624 (step 5).

About 20% of the drift in #7617 needed judgment no check can supply:

  • CLAUDE.md still described a removed PR trigger on the full-suite matrix (#4518).
  • Three skills told agents to call update_golden_master.py directly, against golden-master-guidelines.md.
  • The tri-comparison figures (200/201, 2026-08-30) had not been re-audited.
  • Procedures conflicted: a rebase with --force-with-lease vs. "never rebase".

Change: a monthly sweep, or one before each release tag, by an agent run. It compares:

  1. procedures in .claude/skills, .claude/rules, .claude/agents and docs/agents against the workflows and tools they describe (triggers, required steps, the bless path);
  2. README and docs/validation.md claims against their cited evidence, with dates;
  3. contradictions between docs.

It files issues and never edits files, because most of these fixes need an owner decision. Each issue names both sides, with file:line references. Parallel read-only agents, one per doc group, as in #7617, keep the cost down; the doc-refs audit has already removed the mechanical half.

Acceptance: a documented runbook (a skill or a docs/agents/ page) with the doc groups, the comparison list and the issue format. The first run files its findings.

Ngôn ngữ chính
Python
Star
57
Fork
11
Merge trung bình
1 giờ 32 phút
Pull request đã merge (30 ngày)
974

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 squid-protocol/gitgalaxy

Tất cả issue của squid-protocol/gitgalaxy

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.