FPSMS-backend/.cursor/rules/gen-commit-test-plan.mdc

---
description: When user asks to gen test plan(s) for new/recent commit(s), auto-run the Word generator
alwaysApply: true
---

# Gen commit test plans (simple ask)

If the user says anything like:

- 「gen test plan」 / 「generate test plan」
- 「new commit test plan」 / 「test plan for commit」
- 「產測試計畫」 / 「產生 commit 測試計畫」
- 「有新 commit，幫我出 test plan」

Then **do this immediately** (do not only explain):

1. Default range: **new / recent commits** = `HEAD~10..HEAD`  
   - If user gives a SHA or `A..B`, use that.  
   - If they say “latest / this commit”, use `HEAD~1..HEAD`.  
   - If they say “since last deploy” and give a SHA, use `<sha>..HEAD`.
2. Run from repo root:
   ```bash
   python scripts/generate_commit_test_plans_docx.py <range>
   ```
3. Tell them the output folder: `docs/deploy/commit-plans/` and point to `_index.md`.
4. Optionally refine the **latest** commit’s plan from the real diff if steps look too generic.

Team how-to: `docs/deploy/HOW_TO_GENERATE_COMMIT_TEST_PLANS.md`