install · v2.8.0

Install vào repo của bạn

Bộ cài này cố tình không tự sửa project của bạn. ./install.sh chỉ stage một release bất biến vào .astraler/releases/<version> rồi dừng ở đó. Phần tích hợp do một agent chạy ngay trong repo của bạn thực hiện, sau khi nó đọc build command, agent config và trạng thái Git thật.

Tôi tách thành hai bước vì một bộ cài kiểu chép đè sẽ luôn đè nhầm file. Nó không phân biệt được thứ thuộc về harness, thứ thuộc về project và thứ do owner sở hữu. Cái giá là bạn phải chạy thêm một session agent và đọc kỹ những gì nó định làm, thay vì gõ một lệnh rồi bỏ đi.

Cần sẵn

Install

  1. ./check-requirements.sh
  2. ./install.sh /path/to/your-repo
  3. cd /path/to/your-repo
claude "Read .astraler/releases/2.8.0/ADAPT-HARNESS.md completely and execute it."
  4. claude --agent thomas

Bốn skill cho repo có sẵn

Bốn skill dưới đây có mặt vì repo thật hiếm khi sạch. bootstrap-glossary rút từ vựng miền ra từ chính code; mỗi từ mang theo file nó được đọc ra và bị đánh dấu chưa duyệt cho tới khi owner xác nhận. Nguyên tắc là trích, không bịa: một glossary do agent tưởng tượng ra nhưng viết bằng giọng chắc chắn còn nguy hiểm hơn là không có glossary.

batch-triage xử lý một backlog thừa kế trong một lượt thay vì từng ticket một. legacy-testing dựng seam cho đoạn code không có điểm bám nào để test. untangle dành cho repo không còn module boundary nào để cải thiện, nơi một cú restructure sạch sẽ tạo ra một diff không ai review nổi.

Cái giá chung của cả bốn: đây là việc phải làm xong trước khi ticket đầu tiên chạy được.

  • batch-triage

    Triage an inherited backlog in one pass — many existing issues at once, rather than one new item at a time.

  • bootstrap-glossary

    Seed CONTEXT.md with the domain terms the code already uses, each term carrying the file it was read from and marked unreviewed until the owner confirms it.

  • legacy-testing

    How to get existing untested code under test — characterisation tests that pin current behaviour, and creating a seam before TDD can attach.

  • untangle

    A refactor path for code too tangled for improve-codebase-architecture — where there are no module boundaries to improve, everything imports everything, and a clean restructure would be one enormous unreviewable change.