菜单
Xem tình hình dự án, đo tiến độ, phân tích vấn đề. Read-only, không sửa file. Dùng khi user hỏi 'tình hình thế nào?', muốn xem dashboard, tổng hợp metrics, hoặc chẩn đoán 'có vấn đề gì không?'. Mọi câu hỏi mang tính quan sát, đo lường, chẩn đoán về dự án đều dùng skill này.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Đúc kết cả inbox knowledge thành tri thức có cấu trúc: knowledge page, skill, hoặc workflow. Ưu tiên cập nhật cái có sẵn hơn tạo mới. Dùng khi user nói 'đúc kết', 'xử lý inbox', 'gộp bài học thành wiki', 'promote', hoặc khi inbox knowledge đã tích đủ cần chưng cất thành tài liệu chính thức. KHÔNG dùng khi ghi nhanh 1 mẩu (dùng pk-capture) hoặc xử lý inbox execution (dùng pk-track).
Orchestrator cho bộ pk-*. Dùng khi yêu cầu phức hợp cần phối hợp nhiều skill (vừa plan vừa track, vừa capture vừa distill), hoặc khi không rõ nên dùng skill pk-* nào. Cũng dùng khi user muốn xem bức tranh toàn cảnh dự án, hoặc yêu cầu workflow nhiều bước liên quan .cockpit/. KHÔNG dùng nếu yêu cầu rõ ràng khớp một skill pk-* cụ thể.
Khởi tạo dự án mới hoặc sửa KR target/mục tiêu/constraints/tools (cấu trúc mục tiêu). Tạo cấu trúc .cockpit/ lần đầu. Dùng khi user bắt đầu dự án từ đầu, sửa OKR, thêm/bớt công cụ, thay đổi constraints, hoặc cần thiết lập lại mục tiêu. KHÔNG dùng khi cập nhật KR current tiến độ hàng ngày (dùng pk-track).
Kiểm tra sức khoẻ hệ thống .cockpit/: link hỏng, registry lệch, file mồ côi, schema cũ. 3 mode: check (rà soát read-only), fix (sửa + rebuild index), evolve (nâng cấp schema). Dùng khi user nói 'lint', 'kiểm tra hệ thống', 'dọn dẹp cockpit', 'audit', 'rebuild index', hoặc nghi ngờ dữ liệu cockpit bị lệch.
Tạo hoặc sửa kế hoạch hành động: plan, milestones, actions, dependencies, deadline. Dùng khi user cần lập kế hoạch, phân rã mục tiêu thành bước cụ thể, thêm/sửa/xoá action, điều chỉnh milestone. Thay đổi CẤU TRÚC kế hoạch dùng skill này. Thay đổi TIẾN ĐỘ dùng pk-track.
Thư viện reference nội bộ cho bộ pk-* (schemas, metrics, quality gate). KHÔNG BAO GIỜ gọi trực tiếp. Skill này không có flow riêng. Các skill pk-* khác tự đọc file reference khi cần.
| name | pk-analyze |
| description | Xem tình hình dự án, đo tiến độ, phân tích vấn đề. Read-only, không sửa file. Dùng khi user hỏi 'tình hình thế nào?', muốn xem dashboard, tổng hợp metrics, hoặc chẩn đoán 'có vấn đề gì không?'. Mọi câu hỏi mang tính quan sát, đo lường, chẩn đoán về dự án đều dùng skill này. |
.cockpit/ tồn tại. Thiếu → route pk-init (mode new), KHÔNG nạp gì thêm, dừng.SNAPSHOT_LOADED → tự nạp full theo Snapshot Contract
(../pk-shared/references/snapshot-contract.md) rồi đặt marker SNAPSHOT_LOADED. Đã có marker (vd
harness Phase 1 đã đặt) → skip, không đọc lại.Đọc .cockpit/, tính metrics, phát hiện vấn đề, xếp ưu tiên. KHÔNG BAO GIỜ ghi file.
../pk-shared/references/metrics.md). Số liệu trích từ file.Snapshot Contract (../pk-shared/references/snapshot-contract.md, mục "Context Snapshot") đã preload đủ phần chỉ mục/định danh. KHÔNG đọc lại các nguồn này.
Đọc thêm (DELTA) ngoài snapshot, song song:
| File | Đọc gì | Dùng để |
|---|---|---|
objective.md body | Bảng KR/KI targets + current | Tính metrics |
plan.md body | Roadmap section | Đọc milestone/action structure (focus track, full) |
log/ | Entries gần nhất | Chỉ mode deep: tốc độ hoàn thành, trends |
Mọi công thức ở ../pk-shared/references/metrics.md. KHÔNG chép lại.
Quét theo nghiêm trọng:
../pk-shared/references/metrics.md): orphan count, freshness thấp. Nghi ngờ index lệch → gợi ý chạy pk-lint check (registry sync là việc pk-lint, không phải metrics pk-analyze).First-match: overdue → block action khác → deadline trong horizon → priority cao doing → KR at-risk.
Dashboard hiển thị CẢ HAI module:
Dashboard: [Tên Objective]
[Câu tổng quan]
[Nhắc review nếu có]
Period: [start] > [end] ([X]% thời gian)
Key Results
KR1: ████░░░░░░ 40/100 (40%) > on-track
Active: 2 doing | 1 blocked | 0 pending
Actions: N tổng | X done | Y doing | Z blocked
Inbox execution: [N] pending
Knowledge
Wiki: [N] pages ([M]% fresh)
Skills: [N] | Workflows: [N]
Inbox knowledge: [N] pending
Cần chú ý
- [issues]
Chỉ hiện Knowledge section. Skip execution hoàn toàn.
Bổ sung:
| Param | Mặc định | Mô tả |
|---|---|---|
| mode | light | light: dashboard tiêu chuẩn (không đọc log, không root cause). mode=deep bật phần "Mode deep" (đọc log, root cause >= 3 "tại sao?", tốc độ hoàn thành). |
| focus | full | "full", "progress", "issues", "priority", "knowledge", "track" |
| max_items | 2 (dashboard), 3 (track) | Số priority items |
| horizon_days | 3 (dashboard), 7 (track) | Cửa sổ deadline |
Ghi chú: focus=track (tracking nhẹ) chỉ tính progress + quét issues loại 1-3. Ngữ cảnh track dùng max_items=3, horizon_days=7. mode và focus là hai chiều độc lập: mode kiểm soát độ sâu phân tích, focus kiểm soát phạm vi hiển thị.