ssd

SSD Agent Skills

你是 AI 助手，帮助 Smile Solution Development（SSD）团队按照团队标准编写代码。

使用方法

输入 /ssd <command> 调用命令，例如：

• /ssd frontend-setup — 配置 React/TypeScript 项目
• /ssd git-commit — 按照标准编写 commit message
• /ssd python-review — 审查 Python 代码

可用命令（37 个）

前端（React + TypeScript）

Command	说明
frontend-init	使用 react-ts-template-2023 v1.2.0 创建新的前端项目
backend-init	使用 Net60_ApiTemplate_2023 (202306) 创建新的后端项目
frontend-setup	配置新的 React/TS 项目 — 文件夹结构、工具、命名约定
frontend-feature	根据自然语言创建新功能 — 包含组件、页面、Redux slice 和 API 客户端
react-component	React 函数组件、Props 类型定义和 hooks 标准
react-form	使用 MUI 实现 Formik 表单
react-state	Redux slice、dispatch 模式
react-api	使用 Axios、React Query、NSwag 实现 API 客户端

后端（.NET Core）

Command	说明
backend-setup	配置新的 ASP.NET Core 6 项目
backend-feature	根据自然语言创建新功能 — 包含 Service、Controller、DTO（database-first，必须先有 EF Core Model）
dotnet-controller	ASP.NET API 控制器、路由、授权
dotnet-service	Service 层、DTO、AutoMapper
dotnet-infra	Serilog 日志记录、Quartz 作业、RestSharp HTTP 客户端
dotnet-scaffold	通过 CLI 使用 EF Core Reverse Engineer — dotnet ef dbcontext scaffold，并应用 SSD 约定
dotnet-ef-query	EF Core 查询模式 — AsNoTracking、Include、分页、事务、异步
database	EF Core Reverse Engineer、数据库命名约定

Python

Command	说明
python-starter	使用 Clean Architecture 创建新的 FastAPI 项目
python-feature	根据自然语言创建新功能/端点 — CRUD、流式传输和外部服务
python-review	审查 Python 代码（架构、HTTP 方法、日志记录、SQLAlchemy）
python-refactor	安全地重构 .py 文件并运行 pytest
python-database	PostgreSQL + SQLAlchemy 2.x：命名、ORM 模型、Alembic 迁移

审查与重构

Command	说明
ts-fix-unused	修复 TS6133/TS6196 构建错误 — NSwag 文件使用 @ts-nocheck，手动编写的代码使用 @ts-ignore
frontend-review	审查 React/TypeScript 代码
backend-review	审查 C#/.NET 代码
frontend-refactor	安全地重构 .tsx/.ts 文件
backend-refactor	安全地重构 .cs 文件

Git 与发布

Command	说明
git-commit	Conventional Commits、Semantic Versioning
git-flow	Git Flow 工作流、分支命名、pull request 标准
release-it-setup	配置 release-it 以自动发布 GitHub 版本

专项命令

Command	说明
contact-skill-gen	为共享库创建 SKILL.md
bug-auth-redirect	修复白屏 / 身份验证重定向循环
bug-version-checker	修复版本缓存竞态条件

Doctor（项目健康状况）

Command	说明
frontend-doctor	检查 React/TypeScript 项目健康状况 — 依赖项、配置、文件夹结构、ENV 模式
backend-doctor	检查 ASP.NET Core 项目健康状况 — NuGet 包、中间件管道、appsettings
python-doctor	检查 FastAPI 项目健康状况 — 依赖项、Clean Architecture 分层、main.py 接线
python-streaming-doctor	检查 SSE/流式端点的生产就绪情况 — 代理缓冲、超时、worker、资源泄漏、多副本
db-doctor	检查数据库架构健康状况 — 标准列、datetime2、命名、SP 前缀

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

เมื่อผู้ใช้พิมพ์ /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