mcpField
S
ssd

ssd

github.com/pratchaya0Development140 installsUpdated 17w ago
Repository

About ssd

ssd is a collection of commands for Smile Solution Development teams to create, review, refactor, and check React/TypeScript, ASP.NET Core, and FastAPI projects against shared conventions. It also covers Git practices and releases.

Key features

  1. 0137 commands across three stacks
  2. 02Project setup and feature generation
  3. 03Code review and refactoring
  4. 04Project and database health checks
  5. 05Git commit and release guidance

Use cases

  1. 01Start a React/TypeScript or ASP.NET Core project
  2. 02Generate features for supported stacks
  3. 03Review or refactor code against team conventions
  4. 04Check project or database configuration

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pratchaya0/ssd-agent-skills --skill ssd

After installing, type/ssdin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

reference/
backend-doctor.md
backend-feature.md
backend-init.md
backend-refactor.md
backend-review.md
backend-setup.md
bug-auth-redirect.md
bug-version-checker.md
contact-skill-gen.md
database.md
db-doctor.md
dotnet-controller.md
dotnet-ef-query.md
dotnet-infra.md
dotnet-scaffold.md
dotnet-service.md
frontend-doctor.md
frontend-feature.md
frontend-init.md
frontend-refactor.md
frontend-review.md
frontend-setup.md
git-commit.md
git-flow.md
python-database.md
python-doctor.md
python-feature.md
python-refactor.md
python-review.md
python-starter.md

Details

From the project README

SSD Agent Skills

คุณคือ AI assistant ที่ช่วยทีม Smile Solution Development (SSD) เขียนโค้ดตามมาตรฐานของทีม

วิธีใช้

พิมพ์ /ssd <command> เพื่อเรียกใช้คำสั่ง เช่น:

  • /ssd frontend-setup — ตั้งค่าโปรเจค React/TypeScript
  • /ssd git-commit — เขียน commit message ตามมาตรฐาน
  • /ssd python-review — review Python code

คำสั่งที่มี (37 commands)

Frontend (React + TypeScript)
Commandรายละเอียด
frontend-initเริ่มโปรเจค Frontend ใหม่จาก react-ts-template-2023 v1.2.0
backend-initเริ่มโปรเจค Backend ใหม่จาก Net60_ApiTemplate_2023 (202306)
frontend-setupตั้งค่าโปรเจค React/TS ใหม่ — folder structure, tools, naming conventions
frontend-featureสร้าง feature ใหม่จาก natural language — components, pages, Redux slice, API client ครบ
react-componentมาตรฐาน React functional component, Props typing, hooks
react-formFormik form implementation กับ MUI
react-stateRedux slice, dispatch patterns
react-apiAPI client ด้วย Axios, React Query, NSwag
Backend (.NET Core)
Commandรายละเอียด
backend-setupตั้งค่าโปรเจค ASP.NET Core 6 ใหม่
backend-featureสร้าง feature ใหม่จาก natural language — Service, Controller, DTO ครบ (database-first, ต้องมี EF Core Model ก่อน)
dotnet-controllerASP.NET API controllers, routing, authorization
dotnet-serviceService layer, DTO, AutoMapper
dotnet-infraSerilog logging, Quartz jobs, RestSharp HTTP clients
dotnet-scaffoldEF Core Reverse Engineer ผ่าน CLI — dotnet ef dbcontext scaffold พร้อม SSD conventions
dotnet-ef-queryEF Core query patterns — AsNoTracking, Include, pagination, transaction, async
databaseEF Core Reverse Engineer, database naming conventions
Python
Commandรายละเอียด
python-starterเริ่มโปรเจค FastAPI ใหม่ด้วย Clean Architecture
python-featureสร้าง feature/endpoint ใหม่จาก natural language — CRUD และ streaming + external service
python-reviewReview Python code (architecture, HTTP methods, logging, SQLAlchemy)
python-refactorRefactor .py files อย่างปลอดภัยพร้อม pytest
python-databasePostgreSQL + SQLAlchemy 2.x: naming, ORM models, Alembic migration
Review & Refactor
Commandรายละเอียด
ts-fix-unusedแก้ TS6133/TS6196 build errors — @ts-nocheck สำหรับ NSwag files, @ts-ignore สำหรับ manual code
frontend-reviewReview React/TypeScript code
backend-reviewReview C#/.NET code
frontend-refactorRefactor .tsx/.ts files อย่างปลอดภัย
backend-refactorRefactor .cs files อย่างปลอดภัย
Git & Release
Commandรายละเอียด
git-commitConventional Commits, Semantic Versioning
git-flowGit Flow workflow, branch naming, pull request standards
release-it-setupตั้งค่า release-it สำหรับ automated GitHub releases
Specialized
Commandรายละเอียด
contact-skill-genสร้าง SKILL.md สำหรับ shared libraries
bug-auth-redirectแก้ white screen / auth redirect loop
bug-version-checkerแก้ version cache race condition
Doctor (Project Health)
Commandรายละเอียด
frontend-doctorตรวจสุขภาพโปรเจค React/TypeScript — dependencies, config, folder structure, ENV pattern
backend-doctorตรวจสุขภาพโปรเจค ASP.NET Core — NuGet packages, middleware pipeline, appsettings
python-doctorตรวจสุขภาพโปรเจค FastAPI — dependencies, Clean Architecture layers, main.py wiring
python-streaming-doctorตรวจ production-readiness ของ SSE/streaming endpoint — proxy buffering, timeout, worker, resource leak, multi-replica
db-doctorตรวจสุขภาพ Database schema — standard columns, datetime2, naming, SP prefix

วิธีตอบสนองต่อคำสั่ง

เมื่อผู้ใช้พิมพ์ /ssd <command>:

  1. ตรงกับคำสั่งใดคำสั่งหนึ่งทั้งหมด (exact match) — โหลดไฟล์ reference ที่ตรงกันจาก reference/<command>.md, ปฏิบัติตามมาตรฐาน SSD ที่ระบุในไฟล์นั้นทุกข้อ, เขียนโค้ดตาม conventions ที่กำหนดเท่านั้น ห้ามเบี่ยงเบน
  2. ไม่ได้ระบุคำสั่ง หรือพิมพ์ help / --help / -h / ? / -? — แสดงรายการคำสั่งทั้งหมดข้างต้น (จัดกลุ่มตามหมวด) แล้วถามว่าต้องการใช้คำสั่งใด
  3. พิมพ์ไม่ครบ/ไม่ตรงกับคำสั่งใดเลย (partial) — แตกชื่อคำสั่งทั้งหมดด้วย - เป็น segment แล้วค้นหาคำสั่งที่มี segment ใด segment หนึ่ง "ขึ้นต้น" ด้วยข้อความที่พิมพ์ (prefix match ต่อ segment, ไม่สนตัวพิมพ์เล็ก/ใหญ่) ครอบคลุมทั้ง segment แรก (หมวด) และ segment ท้าย (keyword) เช่น:
    • พิมพ์ dotn → ตรงกับ segment แรกของ dotnet-controller, dotnet-service, dotnet-infra, dotnet-scaffold, dotnet-ef-query (5 คำสั่ง → แสดงเป็น plain text ห้ามใช้ AskUserQuestion)
    • พิมพ์ doctor → ตรงกับ segment ท้ายของ frontend-doctor, backend-doctor, python-doctor, db-doctor
    • พิมพ์ review → ตรงกับ segment ท้ายของ frontend-review, backend-review, python-review
    • เจอ 1 คำสั่ง — แนะนำคำสั่งนั้นทันที พร้อมคำอธิบายสั้นๆ และบรรทัด "ลองพิมพ์: /ssd <command>"
    • เจอมากกว่า 1 คำสั่ง แต่ไม่เกิน 4 คำสั่ง — แสดงเฉพาะคำสั่งที่ตรง (ไม่ใช่ทั้งหมด) พร้อมคำอธิบาย แล้วใช้ AskUserQuestion ถามผู้ใช้ว่าต้องการคำสั่งใดจากรายการที่ตรงนั้น (ใส่ทุกคำสั่งที่ตรงเป็น option — AskUserQuestion รับ option ได้สูงสุด 4 ตัวเท่านั้น)
    • เจอมากกว่า 4 คำสั่ง — ห้ามใช้ AskUserQuestion (option เกิน 4 จะถูกตัดออกบางส่วนโดยไม่มีกฎว่าตัดตัวไหน ทำให้บางคำสั่งเลือกไม่ได้) แสดงรายการคำสั่งที่ตรงทั้งหมดเป็นข้อความ แล้วถามให้ผู้ใช้พิมพ์ชื่อคำสั่งที่ต้องการจากรายการนั้นแทน
    • ไม่เจอเลย — fallback กลับไปแสดงรายการคำสั่งทั้งหมดและถามว่าต้องการใช้คำสั่งใด (เหมือนข้อ 2)

บริบทร่วม (Shared Standards)

มาตรฐานเหล่านี้ใช้กับทุก skill:

Stack หลัก:

  • Frontend: React 18.2 + TypeScript + Vite 4.3.9 + MUI v5
  • Backend: ASP.NET Core 6 + Entity Framework Core 6
  • Python: FastAPI + SQLAlchemy 2.x + Clean/Hexagonal Architecture

Encoding: UTF-8, line ending CRLF (Windows)

Naming:

  • TypeScript: PascalCase (class/component), camelCase (var/func), CONSTANT_CASE (constants)
  • C#: PascalCase (class/method), camelCase (local), _camelCase (private field)
  • Python: snake_case (func/var), PascalCase (class)

ข้อห้ามสากล:

  • ห้ามใช้ any type ใน TypeScript
  • ห้ามใช้ f-string ใน logging (Python)
  • ห้าม DELETE/PUT/PATCH ใน API ทุก stack (C#/.NET, Python) — มาตรฐานบริษัทใช้ REST API ไม่ใช่ RESTful มี HTTP method แค่ GET กับ POST เท่านั้น ใช้ POST + action path เช่น {id}/update, {id}/delete

config file: CLAUDE.md

Comments

Markdown supported