# Okr Shared

> Quy tắc chung mọi OKR skill: SOT ownership, schemas, Quality Gate, priority.

- Skill: `hoangvantuan/okr-shared` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add hoangvantuan/okr-shared`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hoangvantuan/okr-shared/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: hoangvantuan (https://skillmd.com/u/hoangvantuan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hoangvantuan/okr-shared

---


# OKR Shared: Domain Knowledge dùng chung

Chứa quy tắc và schema áp dụng cho mọi skill OKR. Không chạy độc lập. Đọc khi cần.

## Nội dung

| File | Mô tả | Skill dùng |
|------|-------|------------|
| `references/preload.md` | Preload Contract: context nền phải nạp trước khi chạy (Tier 1 full / Tier 2 minimal), `context/index.md` conditional, và Reachability khi ghi | Mọi skill (chạy ở đầu flow) |
| `references/schemas.md` | Roadmap table format, Inbox Aging, Inbox type → Delegate mapping, Archive Rules | `okr-plan` (render Roadmap), `okr-track` (archive, inbox) |
| `references/sot-ownership.md` | Bảng phân vai field: skill nào được sửa gì | Mọi skill (check trước ghi) |
| `references/quality-gate.md` | 3 câu check: đủ cụ thể? giả định ẩn? mâu thuẫn? | `okr-init`, `okr-plan` (trước mỗi follow-up) |
| `references/delegate-protocol.md` | Pre-confirmed flow + reason display khi áp dụng thay đổi cấu trúc | `okr-track` (gửi), `okr-init`/`okr-plan` (nhận) |
| `references/action-priority.md` | Thuật toán chọn action ưu tiên (first-match, top N) | `okr-analyze` (xếp priority), `okr-track` (đề xuất next) |
| `references/metrics.md` | Công thức tính (KR%, KR/KI status, trend, period overdue) + tín hiệu chẩn đoán (action health, capacity signals) | `okr-analyze` (render + issue), `okr-track` (compute trước ghi), `okr-init`/`okr-plan` (capacity fit) |

## Khi nào đọc

- **Mọi skill (đầu flow)**: `preload.md` xác định context nền phải nạp trước khi thao tác. Idempotent: qua harness thì đã nạp, gọi lẻ thì tự nạp phần thiếu. Tier 1 (analyze/init/plan/track/harness) full + conditional `context/index.md`; Tier 2 (capture/retro) minimal.
- **okr-analyze**: `metrics.md` khi tính metrics + phát hiện issue. `action-priority.md` khi xếp priority. `schemas.md` khi cần hiểu Roadmap format.
- **okr-init / okr-plan**: `quality-gate.md` trước mỗi follow-up. `schemas.md` khi render Roadmap. `sot-ownership.md` khi check quyền ghi. `delegate-protocol.md` khi nhận pre-confirmed payload. `metrics.md` (section Capacity signals) khi check fit.
- **okr-track**: `metrics.md` khi compute lại KR/KI status trước ghi (hoặc khi chạy không qua analyze). `delegate-protocol.md` khi đề xuất thay đổi cấu trúc. `schemas.md` khi archive + xử lý inbox. `action-priority.md` khi đề xuất next action. `sot-ownership.md` khi check quyền ghi.
- **okr-retro**: `sot-ownership.md` khi check quyền ghi `.okr/lessons/**`.

## Auto-load + áp dụng lessons

`lessons/index.md` là một phần của **Preload Contract** (`references/preload.md`): Tier 1 và Tier 2 đều nạp toàn bộ index mỗi phiên (idempotent, không đọc trùng). Chỉ index, không đọc file detail (load on-demand khi cần một bài cụ thể).

Cách áp dụng lessons (đối chiếu essence liên quan trước khi đề xuất/ghi) định nghĩa canonical ở `references/preload.md` mục "Áp dụng lessons". Không lặp lại ở đây để tránh drift.

`context/index.md` là phần conditional của Tier 1 khi `context/` tồn tại. Chỉ preload index. Body `context/<slug>.md` đọc on-demand theo `preload.md` "Áp dụng context". Không định nghĩa lại bản đồ neo ở đây.