AI Sprint Kit (SPK)
apipoj/spk
21 subagentes + 18 skills para desenvolvimento autônomo no Claude Code
Ver no GitHubAgent modular para Claude Code que instala 21 subagentes especializados (4 orquestradores + 17 especialistas) com 18 skills reutilizáveis. Funciona como plugin com hot-reload, oferecendo workflows guiados para planejamento, desenvolvimento, debug e design sem necessidade de restart.
Instalação
npx convez-ai apipoj/spk1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Planejar e implementar features com revisão automática de planos
- Debugar problemas complexos com análise de causa raiz
- Design visual com múltiplas direções e comparison boards
- Preparar PRs com checklist de segurança e confirmação explícita
- Prototipagem rápida com jumpstart guiado em 60 segundos
Veredito

SPK é um framework robusto para potencializar Claude Code em projetos reais, com orquestração sofisticada (Bala, Sunzi) e workflows opinionados que garantem qualidade. Recomendado para equipes que querem automação de desenvolvimento com controle humano explícito em pontos críticos.
README
A tradução para o português deste README ainda está na fila.
AI Sprint Kit (SPK)

ระบบ skills & subagent development สำหรับ Claude Code ติดตั้งเป็น plugin - hot-reload ใน session ทันที ไม่ต้อง restart
Positioning: Skills-first Subagents - subagent ทำงานเก่งขึ้นเพราะมี reusable skills / playbooks ไม่ใช่แค่ prompt ยาว ๆ
English version: README-EN.md
21 subagents (4 orchestrators + 17 specialists) · 18 skills
ติดตั้ง
/plugin marketplace add apipoj/spk
/plugin install spk@spk
เจอ SSH error? Marketplace clone repo ผ่าน SSH ถ้ายังไม่ได้ตั้ง SSH key บน GitHub ให้ใช้ HTTPS URL เต็มแทน:
/plugin marketplace add https://github.com/apipoj/spk.git /plugin install spk@spk
เสร็จ Plugin hot-reload ให้เอง ไม่ต้อง restart claude
ครั้งต่อไปที่เริ่ม session ใหม่ SPK จะ scaffold ai_context/wiki/ และ ai_context/sources/ ใน project ของคุณอัตโนมัติ
ถ้าติดตั้งไว้แล้ว อัปเดตด้วย:
/plugin update
Skills มี namespace /spk: ให้เอง - พิมพ์ /spk: แล้วจะเห็น /spk:jumpstart, /spk:plan, /spk:code, /spk:review, /spk:bala, /spk:sunzi, /spk:design-shotgun, /spk:debug, /spk:deploy, /spk:pr, /spk:ingest, /spk:prime, /spk:query, /spk:wiki-lint, /spk:tdd, /spk:uninstall
Subagents ก็ namespace spk: ให้เหมือนกัน: spk:planner, spk:architect, ฯลฯ
เริ่มใน 60 วินาที
ติดตั้งเสร็จแล้ว ไม่ต้องเลือกจาก 18 skills เอง — รันคำสั่งเดียว:
/spk:jumpstart
Jumpstart จะเตรียม repo ให้ (สร้าง AGENTS.md ถ้ายังไม่มี) ถาม 1 คำถามว่าอยากทำอะไร (สร้าง feature / แก้ bug / ปรับ UI) แล้วพาไปถึง first win — plan ที่รีวิวได้จริงบน project ของคุณ — โดยถามยืนยัน 1 ครั้งก่อนเขียนโค้ดเสมอ
มีเป้าหมายอยู่แล้วก็พิมพ์ไปเลย: /spk:jumpstart เพิ่มหน้า login
Jumpstart เรียก subagent อะไรบ้าง (คุณไม่ต้องรันคำสั่งพวกนี้เอง — wizard จัดให้):
| ขั้นตอน | เงื่อนไข | Subagent / Workflow ที่เรียก |
|---|---|---|
| 1. Prime repo | เมื่อ AGENTS.md ยังไม่มี | spk:primer |
| 2. Route ตามเป้าหมาย | สร้าง feature | spk:plan-orchestrator (เหมือน /spk:plan) |
| แก้ bug | spk:debugger (เหมือน /spk:debug) | |
| ปรับ UI | spk:designer (เหมือน /spk:design-shotgun) | |
| 3. Implement | หลังคุณยืนยัน "ไปต่อ" 1 ครั้ง | spk:build-orchestrator (เหมือน /spk:code) |
ก่อนถึงขั้น implement (ขั้น 3) jumpstart จะไม่เขียนโค้ด source ใดๆ และจะไม่ push หรือสร้าง PR ให้เลย — ส่วนนั้นยังอยู่ใต้ /spk:pr ที่ต้องยืนยันแยกต่างหาก
Workflow Highlights
/spk:balaใช้หลักพละ 5 เป็น balance check ก่อน plan/code/review/debug: ศรัทธา วิริยะ สติ สมาธิ ปัญญา แปลงเป็น evidence, effort, context, focus, wisdom/spk:sunziใช้หลักซุนวูเป็น strategy lens ก่อนเลือก battle, architecture, rollout หรือ competitive move: รู้เรา รู้เขา เลือก terrain และหา smallest winning move/spk:design-shotgunทำ visual brainstorm แบบ GStack: แตก 3+ design directions, ทำ comparison board, เก็บ feedback แล้วล็อก approved direction ก่อน/spk:code/spk:debugใช้ตอน test fail / behavior เพี้ยน / error ไม่ชัด: ให้spk:debuggerทำ root-cause analysis ก่อนเสนอ fix และต้องมี evidence + regression test recommendation/spk:prใช้เตรียม PR อย่างปลอดภัย: default เป็น prepare-only, ทำ PR body/checklist/safety report ก่อน และต้องขอ explicit confirmation ก่อน push หรือgh pr create/edit/spk:primeเตรียม repo context สำหรับ subagents โดยให้AGENTS.mdเป็น source of truth และให้CLAUDE.mdเป็น pointer@AGENTS.mdเพื่อลด drift ระหว่าง tools/spk:tddบังคับ RED-GREEN-REFACTOR: test ต้อง fail ก่อน implementation แล้วค่อย green/refactor- Orchestrators ใช้ shared subagent contract: prompt ต้อง self-contained, parallel เฉพาะงานไม่ชนไฟล์, retry
BLOCKEDได้หนึ่งครั้ง, และต้องผ่าน verifier gate ก่อนบอกว่า done - WebFetch cache ต่อ URL: เสิร์ฟจาก cache เฉพาะเมื่อ origin ตอบ
304 Not Modifiedผ่าน ETag/Last-Modified revalidation - lookup เอกสารซ้ำใน/spk:queryและ research flow เร็วขึ้นโดยไม่มีความเสี่ยง stale ปิดได้ด้วยSPK_WEBFETCH_CACHE=off
Subagent Squad
| Name | Role | Model | Color | Phase |
|---|---|---|---|---|
plan-orchestrator | orchestrator | claude-opus-4-8 | green | planning |
build-orchestrator | orchestrator | claude-opus-4-8 | blue | building |
audit-orchestrator | orchestrator | claude-opus-4-8 | purple | auditing |
deploy-orchestrator | orchestrator | claude-opus-4-8 | orange | shipping |
prd-writer | specialist | claude-opus-4-8 | green | planning |
business-analyst | specialist | claude-opus-4-8 | green | planning |
architect | specialist | claude-opus-4-8 | green | planning |
planner | specialist | claude-opus-4-8 | green | planning |
designer | specialist | claude-sonnet-4-6 | green | planning |
primer | specialist | claude-sonnet-4-6 | green | planning |
debugger | specialist | claude-opus-4-8 | purple | auditing |
code-auditor | specialist | claude-opus-4-8 | purple | auditing |
implementer | specialist | claude-sonnet-4-6 | blue | building |
tester | specialist | claude-sonnet-4-6 | blue | building |
docs | specialist | claude-sonnet-4-6 | blue | building |
researcher | specialist | claude-sonnet-4-6 | blue | building |
verifier | specialist | claude-sonnet-4-6 | purple | auditing |
pr-manager | specialist | claude-sonnet-4-6 | orange | shipping |
devops | specialist | claude-sonnet-4-6 | orange | shipping |
deployment-smoke | specialist | claude-sonnet-4-6 | orange | shipping |
browser-tester | specialist | claude-sonnet-4-6 | orange | shipping |
Skills / Slash Commands
| Skill | Dispatches to subagent |
|---|---|
/spk:jumpstart | plan-orchestrator |
/spk:plan | plan-orchestrator |
/spk:code | build-orchestrator |
/spk:review | audit-orchestrator |
/spk:bala | verifier |
/spk:sunzi | planner |
/spk:design-shotgun | designer |
/spk:debug | debugger |
/spk:deploy | deploy-orchestrator |
/spk:pr | pr-manager |
/spk:ingest | plan-orchestrator |
/spk:prime | primer |
/spk:query | researcher |
/spk:wiki-lint | audit-orchestrator |
/spk:tdd | build-orchestrator |
/spk:release-check | verifier |
/spk:scoped-tests | tester |
/spk:uninstall | (no subagent) |
Memory
ทุก project ที่ติดตั้ง SPK จะได้ LLM-wiki สไตล์ Karpathy ที่ ai_context/wiki/:
sources/- ไฟล์ raw ที่คุณ drop ลงมา ห้ามแก้ (immutable)wiki/- LLM เป็นคนดูแล page concept / entity / decision ข้ามโยงกันเองindex.md- catalog รวมทุก wiki pagelog.md- log แบบ append-only สำหรับ ingest / query / lint
Drop ไฟล์ลงใน ai_context/sources/ แล้ว auto-ingest จะทำงานให้ ถาม /spk:query "..." แล้ว wiki จะตอบก่อนไปค้น web
Security
ป้องกัน secrets ใน wiki 5 ชั้น:
- ingest-time secret scan
- pre-write fail-closed hook
- lint-time audit
ai_context/sources/ถูก.gitignoreby default.gitignorerespect ระหว่าง wiki-build
Secrets จะไม่หลุดเข้า wiki pages
Hooks
SPK ติดตั้ง hooks ให้อัตโนมัติ ทุกตัว fail-open (ถ้า error จะปล่อยงานผ่าน ไม่บล็อกการทำงานปกติ):
| Hook | Event | ทำอะไร |
|---|---|---|
init-ai-context | SessionStart | scaffold ai_context/ template ครั้งแรก (idempotent ผ่าน version marker) |
wiki-secret-scan | PreToolUse (Write/Edit) | บล็อกการเขียน secret-shaped strings ลง ai_context/wiki/** |
gitignore-guard | PreToolUse (Read/Grep/Glob) | ระหว่าง wiki-build บล็อกการอ่านไฟล์ที่อยู่ใน .gitignore |
webfetch-cache | PreToolUse + PostToolUse (WebFetch) | cache ต่อ URL เสิร์ฟเฉพาะเมื่อ origin ตอบ 304 Not Modified ปิดด้วย SPK_WEBFETCH_CACHE=off |
auto-ingest | PostToolUse (Write) | ไฟล์ใหม่ใน ai_context/sources/ จะถูกแจ้งให้ run /spk:ingest ปรับโหมดด้วย SPK_AUTO_INGEST |
session-reflect | Stop | จบ session แล้วเสนอ (ไม่เขียนไฟล์) ให้บันทึก learning wiki page และ prime AGENTS.md ของ subtree ที่เปลี่ยนใหม่ ปิดด้วย SPK_SESSION_REFLECT=off |
Native Skills (Thai, No Plugin)
ระบบ skills/ ที่ root ของ repo มี native skill copies ภาษาไทยที่ทำงานได้โดยไม่ต้องติดตั้ง plugin เหมาะสำหรับผู้ที่ไม่ใช้ Claude Code plugin system หรือต้องการ skill playbooks แบบ self-contained
วิธีใช้: copy ทั้ง folder skills/spk-<slug>/ เข้าไปที่ .claude/skills/spk-<slug>/ ใน project ของคุณ หรือ ~/.claude/skills/spk-<slug>/ ถ้าต้องการใช้ทุก project เรียกใช้ด้วย /spk-bala, /spk-code, /spk-plan ฯลฯ
Native skills เขียนเป็นภาษาไทย มี prefix spk- และทำงานเป็น main-thread workflow โดยตรง ไม่ขึ้นกับ subagent หรือ plugin
Skills ที่มี:
/spk-bala- ตรวจสอบสมดุลด้วยหลักพละ 5/spk-code- implement จาก plan แบบ TDD/spk-debug- root cause analysis อย่างเป็นระบบ/spk-deploy- deploy และ verify/spk-design-shotgun- visual brainstorm หลายทิศทาง/spk-ingest- นำ source เข้า wiki/spk-plan- วางแผน feature/spk-pr- เตรียม PR อย่างปลอดภัย/spk-prime- prime repo context/spk-query- Q&A แบบ wiki-first/spk-review- code review หลาย pass/spk-sunzi- strategy lens แบบซุนวู/spk-tdd- TDD loop แบบเข้มงวด/spk-uninstall- ถอน SPK ออก/spk-wiki-lint- ตรวจสอบสุขภาพ wiki
ข้อแตกต่างจาก plugin skills:
- เขียนเป็นภาษาไทย
- ไม่ต้องการ plugin install
- ไม่มี
Task()dispatch ไปยัง subagent - Workflow ทำงานบน main thread โดยตรง
- ไม่มี auto-scaffolding wiki/hooks
Plugin skills (/spk:plan, /spk:code, ฯลฯ) ยังคงทำงานเหมือนเดิมหลังติดตั้ง plugin - native skills เป็น alternative path เท่านั้น
ตรวจสอบ native skills: npm run verify:native
Requirements
- Claude Code (subscription - Max หรือ Pro)
- Git
- Node.js 20+ (ใช้ตอน install เท่านั้น agent ไม่ใช้ runtime)
License
MIT