Những thông tin cần chính xác và dễ tra.
Dùng trang này khi cần command names, installed files, package version, validators, state values, hoặc runtime support details.
Package facts#
| Field | Value |
|---|---|
| Package | @haposoft/cafekit |
| Current package version | 0.9.1 |
| Binary | cafekit |
| Bin file | packages/spec/bin/install.js |
| Node engine | >=18.0.0 |
| Required skills | 30 |
| Required agents | 13 |
Command cheatsheet#
Cột thứ hai chỉ ghi lại command surface OpenCode 0.16 đã đóng băng để phục vụ migration lịch sử. OpenCode không còn là runtime hiện tại và các entry này không phải alias cho command Claude hoặc Codex hiện tại.
| Claude Code command | Legacy OpenCode 0.16 command | Purpose |
|---|---|---|
/cf:ask | /question | Trả lời câu hỏi về project và kỹ thuật bằng source evidence trước. |
/cf:brainstorm | /brainstorm | Làm rõ idea trước khi spec. |
/cf:specs | /specs | Tạo process-first plan và flat tasks qua C1/C2. |
/cf:develop | /develop | Execute từng approved flat task. |
/cf:test | /test | Task-aware verification. |
/cf:code-review | /code-review | Review regressions và security. |
/cf:sync | — | Sync observed task Status và final inline Receipt. |
/cf:debug | /debug | Diagnose trước khi fix. |
/cf:fix | /hotfix | Narrow diagnosed fixes. |
/cf:docs | /docs | Bundle tuỳ chọn: create, update, summarize, reconstruct docs. |
/cf:scout | /inspect | Scout source files và structure. |
/cf:route | — | Ghép chuỗi installed ngắn nhất cho công việc cần định tuyến. |
Với bản cài OpenCode 0.16 lịch sử, installer từng tạo slash commands cho surface implementation chính. Skill sync được ship trong shared skill bundle, nhưng installer không tạo wrapper /sync cho OpenCode.
Chọn và nạp skill#
Native selection dùng progressive disclosure: metadata của live catalog xác
định candidate, SKILL.md đã chọn định nghĩa contract, rồi chỉ các references
liên quan mới được đọc. Với yêu cầu explicit hoặc low-risk rõ ràng, invoke trực
tiếp installed skill. Chỉ dùng cf:route khi yêu cầu mơ hồ, nhiều bước, nhiều
domain, hoặc risk cao. Nếu skill hay agent không có, tiếp tục inline khi an toàn
hoặc báo rõ gap; document skills tuỳ chọn chỉ dùng khi đã cài.
Hooks không phải router và không tự chọn capability. Source và installed
projection parity đã được test, nhưng live-model adherence vẫn UNPROVEN; lựa
chọn ngữ nghĩa không tất định và không được đảm bảo.
Claude file structure#
.claude/
├── skills/
├── agents/
├── hooks/
├── references/
├── rules/
├── scripts/
├── runtime.json
├── settings.json
├── status.cjs
└── cafekit.json
Spec state values#
| State | Meaning |
|---|---|
pending | Task chưa bắt đầu. |
in_progress | Task đang active. |
blocked | Task bị chặn; phải ghi blocker. |
done | Task có evidence thật, review, và synced state. |
Validators#
node .claude/scripts/validate-spec-output.cjs specs/<feature>
node .claude/scripts/validate-docs.cjs docs
node .claude/scripts/validate-docs-reconstruct.cjs docs/as-is/<scope>
node .claude/scripts/generate-skill-catalog.cjs --skills