Giao diện
Các khối nền
Mọi framework workflow (Superpowers, Spec Kit, GSD...) và mọi kiểu chạy tự động đều được ráp từ cùng một bộ khối nền. Hiểu 8 khối này thì đọc framework nào cũng thấy quen.
Bộ starter của lab (practice/starter/) dùng gần đủ cả 8 khối. Mỗi trang con lấy ví dụ thật từ đó.
| Khối | Giải quyết vấn đề gì (một dòng) | Bên Codex |
|---|---|---|
| CLAUDE.md / AGENTS.md | Agent mỗi phiên quên sạch quy ước dự án | AGENTS.md |
| Permission mode | Hỏi duyệt từng lệnh thì chậm, không hỏi thì sợ | sandbox_mode + approval_policy, auto-review |
| Skill | Một quy trình lặp lại phải giải thích lại mỗi lần | Skill trong .agents/skills |
| Subagent | Một phiên làm quá nhiều việc thì ngữ cảnh rối | Subagent |
| Hook | Dặn agent "nhớ chạy test" nhưng nó vẫn quên | Hooks (trong plugin/config) |
| MCP | Agent không thấy được trình duyệt, docs mới, GitHub... | [mcp_servers] trong config.toml |
| Plugin | Cài từng skill, hook, MCP bằng tay thì mệt và lệch nhau | Plugin (/plugins) |
| Headless / CI | Muốn agent chạy trong script, CI, vòng lặp, không ai ngồi gõ | codex exec |
Đọc theo thứ tự nào
- Bắt buộc trước buổi lab: CLAUDE.md, Permission mode, Hook. Đây là ba thứ quyết định agent cư xử ra sao trong dự án của bạn.
- Đọc khi gặp trong lab: Skill, MCP, Plugin (lab dùng skill
scaffold-app,verify-appvà vài plugin). - Đọc khi muốn lên nấc 4: Subagent, Headless.
Mỗi trang con có đúng 5 mục: Giải quyết vấn đề gì, Khi nào cần, Ví dụ tối thiểu, Bên Codex, Nguồn.
Nguồn
- Claude Code docs: https://code.claude.com/docs/en/memory
- Codex docs: https://learn.chatgpt.com/docs/agent-configuration/agents-md