| name | be-implement |
| description | Backend implementation workflow for Blog Du Lịch. Use when implementing a new API endpoint, fixing backend logic, adding middleware, or updating DB schema. Loads checklist, spec-reading procedure, and review criteria. Trigger phrases: implement backend, create endpoint, fix API, add route, backend feature, controller, migration. |
| argument-hint | Endpoint or feature to implement (e.g. POST /api/posts) |
BE Implement Skill
Mục tiêu
Implement hoặc fix một backend feature đúng spec, an toàn phân quyền, dễ test.
Nguyên tắc (Quy tắc cứng)
- IRON LAW: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. BẮT BUỘC phải tìm ra nguyên nhân gốc rễ trước khi sửa code. TUYỆT ĐỐI KHÔNG đoán mò.
- RECEIVING CODE REVIEW: Khi nhận feedback sửa lỗi, TUYỆT ĐỐI KHÔNG xin lỗi/khen ngợi. BẮT BUỘC tuân theo quy trình:
READ -> UNDERSTAND -> VERIFY -> EVALUATE -> RESPOND. Trả lời bằng fact kỹ thuật.
Khi nào dùng
- Tạo endpoint mới
- Fix lỗi logic trong controller/route
- Thêm/sửa middleware
- Cập nhật DB schema (migration + seed)
Procedure
Bước 1 — Đọc spec trước khi code
- Tìm file API spec:
demo_docs/api/[Design][API] API{ID}_{Group}_{Name}.md
- Đọc
demo_docs/[Design][DB] DATABASE_Schema.md nếu thay đổi schema
- Xem danh sách API tại
demo_docs/api/[Design][LIST] API_DanhSachEndpoint.md
- Đọc
demo_docs/[Design][COMMON] MESSAGE_Catalog.md; dùng lại Message ID đã có, nếu chưa có thì cập nhật catalog và API doc trước khi code.
Bước 2 — Implement theo checklist
Xem đầy đủ tại checklist.
Tóm tắt bắt buộc:
- Route đúng method/path/prefix (
/api/* hoặc /api/admin/*)
- Controller trả đúng status code
- Validate nhiều lớp (Defense-in-Depth): Boundary -> Business -> Data. Trả 422 khi sai format.
- Auth + role guard đúng (public / member / admin)
- Không expose
password_hash hay secret
- Error format:
{ messageId, message, details? }
Bước 3 — Self-review (Two-Stage)
Thực hiện review theo 2 giai đoạn:
- Stage 1: Spec Compliance: Kiểm tra code có đáp ứng đúng 100% tài liệu thiết kế không.
- Stage 2: Code Quality: Kiểm tra chất lượng code, bảo mật (Defense-in-Depth) và best practices.
Chạy checklist review tại review criteria trước khi báo xong.
Bước 4 — Verify
cd demo_source_be
npm test
Output
### Files changed
- src/routes/...
- src/controllers/...
- src/db/migrations/... (nếu có)
### Behavior summary
...
### Verify result
npm test → PASS | FAIL
📝 Ghi Log Bắt Buộc
Sau khi hoàn thành skill này, PHẢI ghi log vào reports/AGENT_EXECUTION_LOG.md trước khi báo cáo kết quả.
Dùng template sau (copy và điền vào):
### [YYYY-MM-DD HH:mm:ss] - {be-agent | fe-agent | test-agent | playwright-agent | docs-agent}
- **Task**: {Mô tả ngắn gọn việc vừa làm}
- **Skill Used**: {tên skill này}
- **Target Feature**: {key trong PROJECT_MANIFEST.yml, ví dụ: auth_login}
- **Files Processed**:
- `path/to/file` [Modified]
- `path/to/file` [Verified/Unchanged]
- **Status**: SUCCESS | FAILED | PARTIAL
- **Notes**: {Ghi chú: findings, residual risks, việc chưa làm}
⚠️ Nếu bị interrupt, ghi Status: PARTIAL và ghi rõ đã làm đến bước nào.
⚠️ Sau khi ghi log, cập nhật cycle_checkpoint trong PROJECT_MANIFEST.yml.
