Tạo ngữ cảnh dự án (back-fill cho codebase cũ)
Skill của codeArbiter quét codebase sẵn có bằng 6 subagent chỉ-đọc song song rồi dựng lại toàn bộ tài liệu trạng thái dự án mà không đoán bừa.
Làm được gì
Khi một repo đã có mã nguồn nhưng chưa có tài liệu trạng thái dự án, skill này điền ngược (back-fill) tài liệu từ chính mã nguồn đó.
- Tiền kiểm tra: xác nhận
.codearbiter/CONTEXT.mdchưa có marker<!--INITIALIZED-->và thực sự tồn tại mã nguồn có ý nghĩa; nếu không có mã nguồn thì chuyển sang skilldecompose. - Phái 6 scout song song: tech stack (A), hạ tầng/CI (B), kiến trúc (C), bảo mật (D), kiểm thử (E), mô hình dữ liệu (F). Mỗi scout chỉ đọc một lát cắt và trả về báo cáo có cấu trúc — đường dẫn, số dòng, tên giá trị — tuyệt đối không trả mã nguồn thô.
- Tổng hợp theo độ tin cậy: HIGH ghi thành sự thật, MEDIUM ghi kèm ghi chú suy luận, LOW để placeholder
[CONFIRM-NN]. - Phỏng vấn khoảng trống: hỏi người dùng từng câu một, chỉ hỏi những gì scout không xác định được; câu trả lời mơ hồ sẽ bị chất vấn lại.
- Ghi và khoá: tạo
CONTEXT.md,tech-stack.md,coding-standards.md,security-controls.md,open-questions.md,open-tasks.md,overrides.logvà (có điều kiện)release-targets.md, rồi khoá bằng marker khởi tạo.
Phù hợp với ai
- Đội nhóm đã dùng plugin codeArbiter và cần onboard một repo legacy không có tài liệu.
- Người muốn tóm tắt codebase lớn mà không nạp mã nguồn thô vào ngữ cảnh chính.
- Người cần ghi nhận tình trạng bảo mật mà không lộ giá trị bí mật (chỉ đường dẫn + số dòng).
Lưu ý: skill phụ thuộc vào cấu trúc
.codearbiter/và các script như{{PLUGIN_ROOT}}/hooks/taskwrite.py, nên rất khó dùng tách rời.
Ví dụ sử dụng
- Onboard monorepo 5 năm tuổi không có docs — chạy
/create-context, 6 scout đọcpackage.json,.github/workflows/,prisma/schema.prisma… và sinh bản nháp tech-stack, lệnh build, danh sách entity. - Tự kích hoạt lúc khởi động phiên — nếu
CONTEXT.mdtồn tại nhưng thiếu<!--INITIALIZED-->, hệ thống tự định tuyến vào skill này để hoàn tất khởi tạo dang dở. - Suy ra mục tiêu release — chỉ khi có đúng một manifest và một CHANGELOG ở gốc repo thì mới ghi
release-targets.md; trường hợp mơ hồ sẽ để[CONFIRM-NN]thay vì đoán.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/arbiterForge/codeArbiter/HEAD/core/surface/skills/context-creation/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục core/surface/skills/context-creation từ repo GitHub arbiterForge/codeArbiter vào ~/.claude/skills/context-creation/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/arbiterForge/codeArbiter.git && mkdir -p ~/.claude/skills/context-creation && cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và chuyển đến thư mục làm việc của bạn.
- Tải mã nguồn:
git clone https://github.com/arbiterForge/codeArbiter.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills/context-creation - Sao chép tệp:
cp -r codeArbiter/core/surface/skills/context-creation/* ~/.claude/skills/context-creation/ - Vì skill phụ thuộc vào toàn bộ plugin codeArbiter (các hook
hooks/taskwrite.py,hooks/_releaselib.py,includes/cut-docs.md), nên tốt nhất hãy cài đặt cả plugin theo hướng dẫn trong README của repo. - Khởi động lại Claude Code, mở một repo chưa có tài liệu rồi chạy
/create-contexthoặc yêu cầu: "tạo ngữ cảnh dự án từ codebase hiện có". - Xem lại báo cáo của các scout, trả lời từng câu hỏi
[CONFIRM-NN]; sau đó thư mục.codearbiter/sẽ được điền đầy và khoá trạng thái khởi tạo.