f5-question

/f5-question - Q&A Tracking Command

Quản lý câu hỏi và clarification requests trong workflow.

Usage

/f5-question raise --from <source> --severity <level> --tag <tag>
/f5-question list [--status open|resolved|all] [--tag <tag>]
/f5-question show <Q-ID>
/f5-question resolve <Q-ID> --answer "<answer>"

Arguments

• raise: Tạo câu hỏi mới
• list: Xem danh sách Q&A
• show: Xem chi tiết một Q&A
• resolve: Đánh dấu đã giải đáp

---

STEP 1: PARSE SUBCOMMAND

Pattern	Action
raise	Go to [ACTION: RAISE]
list	Go to [ACTION: LIST]
show <Q-ID>	Go to [ACTION: SHOW]
resolve <Q-ID>	Go to [ACTION: RESOLVE]
(default)	Go to [ACTION: HELP]

---

ACTION: RAISE

Tạo câu hỏi mới

Parameters:

• --from <source>: Nguồn của câu hỏi (required)
  • input, classification, DI-SCR-xxx (Phase 1)
  • specs, srs, use-cases (Phase 2)
  • design, basic-design, detail-design (Phase 3)
  • technical-design, api-contract, data-model (Phase 4)
• --severity <level>: Mức độ nghiêm trọng (required)
  • blocking: Không thể tiếp tục implement
  • non-blocking: Có thể implement với assumption
• --tag <tag>: Nhãn phân loại (required)
  • DESIGN-GAP, MISSING-STATE, MISSING-ERROR, MISSING-VALIDATION
  • MISSING-EDGE-CASE, BUSINESS-RULE, REQUIREMENT-UNCLEAR
  • CONSTRAINT, DATA-FORMAT, INTEGRATION, PERFORMANCE, SECURITY
• --source <file>: File/artifact cụ thể (optional)
• --assignee <role>: Người cần trả lời (optional, default: BA)

Process:

1. Đọc _index.yaml để lấy next ID:

   # Check .f5/questions/_index.yaml
   # Get last Q-ID, increment by 1
   

2. Tạo file Q&A mới:

   .f5/questions/open/Q-{ID}.md
   

3. Update _index.yaml

4. Hiển thị kết quả

Output Format:

╔═══════════════════════════════════════════════════════════════════════════╗
║  📝 TẠO CÂU HỎI MỚI                                                       ║
╠═══════════════════════════════════════════════════════════════════════════╣

ID: Q-{ID}
Trạng thái: 🟡 OPEN

Metadata:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

| Field | Value |
|-------|-------|
| **From** | {source} |
| **Source File** | {source_file} |
| **Severity** | {severity} |
| **Tag** | {tag} |
| **Assignee** | {assignee} |
| **Created** | {date} |

NỘI DUNG CÂU HỎI:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Claude sẽ prompt user nhập nội dung câu hỏi]

FILE ĐÃ TẠO:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

→ .f5/questions/open/Q-{ID}.md
→ .f5/questions/_index.yaml (updated)

BƯỚC TIẾP THEO:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Chờ BA/Customer trả lời trong file Q-{ID}.md
2. Sau khi có answer, chạy: /f5-question resolve Q-{ID}

╚═══════════════════════════════════════════════════════════════════════════╝