| name | spk-pr |
| description | เตรียม ตรวจสอบ พุช และเปิด GitHub PR พร้อม PR body แบบ conventional commit และ CI follow-up |
| argument-hint | [title หรือ scope; optional: draft|ready] |
| user-invocable | true |
spk-pr
Skill นี้เป็น manual-only โหมด default คือ prepare-only: สร้าง PR body และ safety report โดยไม่ stage, commit, push หรือสร้าง PR
รวบรวม Context
- ถ้าอยู่ใน git worktree ให้รัน
git status --short --branch --untracked-files=all
- ถ้าอยู่ใน git worktree ให้รัน
git remote get-url origin และ git rev-list --left-right --count HEAD...origin/main; ถ้า remote/main ไม่มี ให้บันทึกว่าไม่มีข้อมูลเปรียบเทียบ
- ถ้าอยู่ใน git worktree ให้รัน
git log --oneline --decorate -8 และ git diff --stat; ถ้าไม่ใช่ git repo ให้รายงานว่า PR context ไม่พร้อมแทนการหยุดด้วย error
- เช็ค
gh auth status
Workflow
- Prepare-only เป็น default ตรวจ branch, remote, dirty/untracked files, diff, outgoing commits, review, gates และ auth แล้วสร้าง title/body, exact paths, test plan, risks โดยห้าม local/remote write
- Resolve writes ถ้า user ขอ commit/push/open/update ให้ list exact paths, commit message, outgoing commits, remote/ref, API operations, title/body digest และ force mode
- Verify secret-scan proposed staged diff ที่แน่นอนและรัน gates ถ้า auth หายหรือ gate fail ให้
BLOCKED
- Bind intent canonicalize proposed write object แบบ stable key ordering แล้วใช้ SHA-256 lowercase hex ครบ 64 ตัว
- ขอ approval ถ้า latest message ไม่มี exact
spk-approve:<intent_digest> ให้คืน envelope และหยุด ห้าม delegate mutating step
- Resume + revalidate คำนวณ state/digest ใหม่ drift ใด ๆ ทำให้ token เป็นโมฆะ
- Execute exact intent ส่ง approved intent + token ให้ PR worker หรือทำ sequential stage เฉพาะ paths ที่ list, commit/push/API write เฉพาะที่อนุมัติ
- Verify outcome รายงาน commit SHA, remote ref, PR URL และ CI state การแก้ CI ที่ write/push ต้อง approval ใหม่
Approval Protocol
{
"schema": "spk.approval/v1",
"status": "NEEDS_USER_INPUT",
"operation": "pull_request_write",
"intent_digest": "<64 lowercase hex>",
"approval_token": "spk-approve:<intent_digest>",
"target": {"remote": "<remote>", "branch": "<branch>", "repository": "<owner/repo>"},
"paths": ["<reviewed path>"],
"commits": ["<outgoing หรือ proposed commit>"],
"commands": ["<exact git/API command + argv>"],
"resume_instruction":
Evidence Receipt
คืน spk.evidence/v1 ที่มี mode, approval digest, paths, commit/ref, PR URL, commands/gates, files ที่ตั้งใจไม่ stage, risks และ next action
Safety Rules
- Default เป็น prepare-only: อย่า stage, commit, push หรือ create/update PR เว้นแต่ถูกขออย่างชัดเจน
- อย่า force-push เว้นแต่ถูกสั่งและใช้
--force-with-lease
- ห้าม network/local write จน exact approval token ผ่าน revalidation
- อย่า push จาก dirty
main โดยไม่ระบุ commit ทั้งหมดที่จะออกไป
- Stage เฉพาะ paths ที่ review แล้ว อย่า
git add . เมื่อมี untracked/generated/operator files
- Secret-scan staged diff ก่อน commit
- ถ้า GitHub auth ไม่มี ให้เตรียม PR body ไว้ที่เครื่องแล้วรายงาน setup steps
