convez.ai
AgenteDesenvolvimento WebIntermediário
apipoj

AI Sprint Kit (SPK)

apipoj/spk

21 subagentes + 18 skills para desenvolvimento autônomo no Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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/spk

1 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

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
v4.0.0
Issues abertas
0
Contribuidores
2

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)

AI Sprint Kit repo banner

ระบบ 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 ตามเป้าหมายสร้าง featurespk:plan-orchestrator (เหมือน /spk:plan)
แก้ bugspk:debugger (เหมือน /spk:debug)
ปรับ UIspk: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

NameRoleModelColorPhase
plan-orchestratororchestratorclaude-opus-4-8greenplanning
build-orchestratororchestratorclaude-opus-4-8bluebuilding
audit-orchestratororchestratorclaude-opus-4-8purpleauditing
deploy-orchestratororchestratorclaude-opus-4-8orangeshipping
prd-writerspecialistclaude-opus-4-8greenplanning
business-analystspecialistclaude-opus-4-8greenplanning
architectspecialistclaude-opus-4-8greenplanning
plannerspecialistclaude-opus-4-8greenplanning
designerspecialistclaude-sonnet-4-6greenplanning
primerspecialistclaude-sonnet-4-6greenplanning
debuggerspecialistclaude-opus-4-8purpleauditing
code-auditorspecialistclaude-opus-4-8purpleauditing
implementerspecialistclaude-sonnet-4-6bluebuilding
testerspecialistclaude-sonnet-4-6bluebuilding
docsspecialistclaude-sonnet-4-6bluebuilding
researcherspecialistclaude-sonnet-4-6bluebuilding
verifierspecialistclaude-sonnet-4-6purpleauditing
pr-managerspecialistclaude-sonnet-4-6orangeshipping
devopsspecialistclaude-sonnet-4-6orangeshipping
deployment-smokespecialistclaude-sonnet-4-6orangeshipping
browser-testerspecialistclaude-sonnet-4-6orangeshipping

Skills / Slash Commands

SkillDispatches to subagent
/spk:jumpstartplan-orchestrator
/spk:planplan-orchestrator
/spk:codebuild-orchestrator
/spk:reviewaudit-orchestrator
/spk:balaverifier
/spk:sunziplanner
/spk:design-shotgundesigner
/spk:debugdebugger
/spk:deploydeploy-orchestrator
/spk:prpr-manager
/spk:ingestplan-orchestrator
/spk:primeprimer
/spk:queryresearcher
/spk:wiki-lintaudit-orchestrator
/spk:tddbuild-orchestrator
/spk:release-checkverifier
/spk:scoped-teststester
/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 page
  • log.md - log แบบ append-only สำหรับ ingest / query / lint

Drop ไฟล์ลงใน ai_context/sources/ แล้ว auto-ingest จะทำงานให้ ถาม /spk:query "..." แล้ว wiki จะตอบก่อนไปค้น web

Security

ป้องกัน secrets ใน wiki 5 ชั้น:

  1. ingest-time secret scan
  2. pre-write fail-closed hook
  3. lint-time audit
  4. ai_context/sources/ ถูก .gitignore by default
  5. .gitignore respect ระหว่าง wiki-build

Secrets จะไม่หลุดเข้า wiki pages

Hooks

SPK ติดตั้ง hooks ให้อัตโนมัติ ทุกตัว fail-open (ถ้า error จะปล่อยงานผ่าน ไม่บล็อกการทำงานปกติ):

HookEventทำอะไร
init-ai-contextSessionStartscaffold ai_context/ template ครั้งแรก (idempotent ผ่าน version marker)
wiki-secret-scanPreToolUse (Write/Edit)บล็อกการเขียน secret-shaped strings ลง ai_context/wiki/**
gitignore-guardPreToolUse (Read/Grep/Glob)ระหว่าง wiki-build บล็อกการอ่านไฟล์ที่อยู่ใน .gitignore
webfetch-cachePreToolUse + PostToolUse (WebFetch)cache ต่อ URL เสิร์ฟเฉพาะเมื่อ origin ตอบ 304 Not Modified ปิดด้วย SPK_WEBFETCH_CACHE=off
auto-ingestPostToolUse (Write)ไฟล์ใหม่ใน ai_context/sources/ จะถูกแจ้งให้ run /spk:ingest ปรับโหมดด้วย SPK_AUTO_INGEST
session-reflectStopจบ 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

Ver o original no GitHub

Bom para

Relacionados