krypton-diff

name	krypton-diff
description	Manual, on-demand review (NOT scheduled) that detects "platform drift" — where new native Copilot CLI features have made bespoke kopi-cli scaffolding (skills/agents/custom logic) redundant or simplifiable. Inventories the scaffolding, compares each against current native capabilities, classifies KEEP / REMOVE-CANDIDATE / WATCH, and emits a report. Goal: cut scaffolding (Article VII). Every removal needs human approval. Run after a notable Copilot CLI release or before a tech-debt cleanup.
license	MIT
allowed-tools	["file-search","bash","web-search"]

Krypton-Diff Skill

Review thủ công, chạy on-demand (1 lần khi cần — KHÔNG định kỳ, KHÔNG tự động) để phát hiện platform drift: những chỗ tính năng native mới của Copilot CLI đã làm scaffolding bespoke của kopi-cli (skill/agent/logic tự chế) trở nên thừa hoặc có thể đơn giản hóa.

Mục tiêu: giảm scaffolding, tránh rot âm thầm — nhưng mọi quyết định gỡ/sửa đều cần human duyệt trước khi thực thi (Article VII: Simplicity Gate).

Không engine. Không daemon. Không scheduler. Chạy bằng file-search + bash + lý luận. Kết quả là một báo cáo tĩnh cho human quyết định.

---

Trigger

• "chạy krypton-diff"
• "kiểm tra platform drift"
• "Copilot CLI vừa ra bản mới — review scaffolding"
• "cái nào có thể gỡ sau update Copilot CLI?"
• Sau khi Copilot CLI phát hành tính năng / API mới đáng kể
• Trước sprint dọn dẹp tech-debt định kỳ

Khi KHÔNG dùng

• Chưa có bản Copilot CLI mới nào ra → không có drift mới để phát hiện.
• Muốn review chất lượng code thông thường → dùng skill code-review.
• Muốn kiểm tra bảo mật → dùng kopi-guard.

---

Quy trình

Bước 1 LIỆT KÊ SCAFFOLDING → Bước 2 ĐỐI CHIẾU NATIVE → Bước 3 PHÂN LOẠI
       → Bước 4 XUẤT BÁO CÁO → Bước 5 TRÌNH HUMAN DUYỆT

Bước 1 — Liệt kê scaffolding bespoke hiện có

Quét toàn bộ scaffolding tự chế của kopi-cli:

# Skills tự chế
ls -1 .github/skills/*/SKILL.md 2>/dev/null

# Agents tự chế
ls -1 .github/agents/*.agent.md 2>/dev/null

# Hooks (nếu có)
find .kopi/hooks/ .github/hooks/ .githooks/ -type f 2>/dev/null || echo "(no hooks dir)"

# Logic tự chế khác (scripts, custom runners)
find . -maxdepth 3 \( -name '*.sh' -o -name '*.mjs' -o -name '*.py' \) \
  | grep -v node_modules | grep -v .git | head -30

Với mỗi item, ghi nhận:

• Tên / đường dẫn
• Chức năng cốt lõi (đọc 5–10 dòng đầu frontmatter/description)
• Lý do tồn tại ban đầu (lúc viết, native còn thiếu gì?)

Bước 2 — Đối chiếu với năng lực native Copilot CLI hiện tại

Với mỗi item trong danh sách Bước 1, đặt câu hỏi:

"Tính năng native nào của Copilot CLI (built-in tool, MCP, agent capability, slash command, skill, v.v.) có thể thay thế toàn phần hoặc một phần chức năng này?"

Nguồn đối chiếu (đọc theo thứ tự):

1. knowledge/ — grep platform hoặc copilot-cli để tìm fact đã harvest từ lần trước.
2. Tài liệu / changelog Copilot CLI mới nhất — dùng web-search để nắm bản mới nhất (built-in tools, slash commands, MCP, agent features). Nếu môi trường offline → ghi rõ "không truy cập được docs" và hạ confidence.
3. Lý luận dựa trên những gì bạn đã biết — ghi rõ mức độ chắc chắn.

Ghi kết quả đối chiếu từng item theo cấu trúc:

item: <tên>
native_candidate: <tính năng native / "không có">
coverage: full | partial | none
confidence: high | medium | low
note: <lý do ngắn gọn>

Bước 3 — Phân loại

Phân loại mỗi item vào một trong ba nhóm:

Nhóm	Điều kiện	Hành động tiếp theo
GIỮ	Native không phủ; hoặc bespoke bổ sung logic đặc thù kopi-cli (nghiệp vụ, chuẩn artifact, v.v.)	Không làm gì
ỨNG VIÊN GỠ	Native đã phủ full (confidence ≥ medium) và bespoke không thêm giá trị rõ ràng	Đề xuất gỡ/thay thế — chờ human duyệt
THEO DÕI	Native phủ partial; hoặc confidence low; hoặc bespoke còn 1 tính năng nhỏ native chưa có	Review lại lần sau

Nguyên tắc bảo thủ: Khi nghi ngờ giữa GIỮ và ỨNG VIÊN GỠ → chọn THEO DÕI. Chỉ flag ỨNG VIÊN GỠ khi bằng chứng native đủ rõ.

Bước 4 — Xuất báo cáo

Tạo báo cáo theo định dạng chuẩn sau:

# Krypton-Diff Report

generated_at: <ISO timestamp>
triggered_by: <lý do chạy — vd "Copilot CLI release vX.Y">
reviewed_by: krypton-diff skill

## Tóm tắt

| Nhóm | Số lượng |
|---|---|
| GIỮ | N |
| ỨNG VIÊN GỠ | N |
| THEO DÕI | N |

Kết luận 1–2 câu: mức độ drift tổng thể cao/thấp; cần hành động gì ngay.

---

## ỨNG VIÊN GỠ (cần human duyệt)

### <tên item>
- **Vị trí:** `<đường dẫn file>`
- **Chức năng hiện tại:** <mô tả ngắn>
- **Native thay thế:** <tên tính năng / tool / lệnh cụ thể>
- **Coverage:** full / partial
- **Confidence:** high / medium
- **Khuyến nghị:** Gỡ / Thay thế bằng X / Đơn giản hoá bằng cách Y
- **Rủi ro nếu gỡ:** <thấp/trung/cao + lý do>
- **Bước thực thi (sau khi human duyệt):**
  1. ...
  2. ...

---

## THEO DÕI

### <tên item>
- **Vị trí:** `<đường dẫn>`
- **Lý do theo dõi:** <native phủ partial vì X; sẽ review lại khi Y>

---

## GIỮ

Liệt kê tên + lý do giữ ngắn (1 dòng mỗi item).

---

## Ghi chú
<!-- Bất kỳ quan sát nào không fit nhóm trên; pattern drift chung; đề xuất cho sprint dọn dẹp -->

Bước 5 — Trình human duyệt

Sau khi xuất báo cáo:

1. Lưu vào artifacts/krypton-diff-<YYYY-MM-DD>.md.
2. Trình bày tóm tắt cho human: bao nhiêu ứng viên gỡ, rủi ro tổng thể.
3. DỪNG và chờ. Không tự thực thi bất kỳ thay đổi nào.
4. Chỉ sau khi human duyệt từng item cụ thể → thực thi theo "Bước thực thi" trong báo cáo, từng item một, có review sau mỗi bước.

Gỡ scaffolding là thay đổi cấu trúc framework — luôn cần human gate, kể cả khi rủi ro thấp.

---

Nguyên tắc (Article IV / VII)

Nguyên tắc	Áp dụng
Không engine/daemon	Skill chạy 1 lần khi được gọi; không lặp, không watch
Simplicity Gate	Mục tiêu chính là GIẢM scaffolding — bản thân skill phải ngắn gọn; không thêm phức tạp
Human gate	Mọi hành động gỡ/sửa đều chờ human approve từng item
Bảo thủ khi nghi ngờ	Khi confidence thấp → THEO DÕI, không GỠ

---

Output

• artifacts/krypton-diff-<YYYY-MM-DD>.md — báo cáo đầy đủ
• Tóm tắt trình bày cho human kèm danh sách ứng viên gỡ ưu tiên nhất