造脚手架Skill一句话秒出API四件套

mkdir -p .claude/skills/endpoint-scaffold/templates
mkdir -p .claude/skills/endpoint-scaffold/examples

.claude/skills/endpoint-scaffold/
├── SKILL.md                 # 薄入口：导航 + 流程
├── templates/
│   ├── route.tpl            # 路由声明模板
│   ├── handler.tpl          # 处理器函数模板
│   ├── test.tpl             # 单测模板
│   └── doc.tpl              # 接口文档模板
└── examples/
    └── one-liner-to-files.md # 一句话→四文件的对照样例

// Auto-scaffolded by endpoint-scaffold skill
import { {{NAME}}Handler } from '../handlers/{{NAME}}.js';

router.{{METHOD_LOWER}}('{{PATH}}', {{NAME}}Handler);

// {{DESC}}
export async function {{NAME}}Handler(req, res) {
  try {
    // TODO: implement business logic for {{METHOD}} {{PATH}}
    res.status(501).json({ error: 'not implemented' });
  } catch (err) {
    res.status(500).json({ error: String(err) });
  }
}

import { describe, it, expect } from 'vitest';
// import { {{NAME}}Handler } from '../handlers/{{NAME}}';

describe('{{METHOD}} {{PATH}}', () => {
  it('should {{DESC}}', async () => {
    // TODO: wire up request mock and assert response
    expect(true).toBe(true);
  });
});

# {{METHOD}} {{PATH}}

{{DESC}}

## Request
TODO

## Response
TODO

---
name: endpoint-scaffold
description: Scaffold a complete API endpoint (route + handler + unit test + API doc) from a one-line spec. Use when the user asks to add/create a new endpoint, generate CRUD scaffolding, or build out a new route with tests and docs.
when_to_use: triggers on phrases like "加个接口", "新建 endpoint", "生成 CRUD", "scaffold a route", "add an API"
argument-hint: [METHOD path description...]
arguments: [method, path, desc]
allowed-tools: Read, Write, Edit, Glob, Bash(ls *), Bash(test *)
---

## Current request
Scaffold the endpoint: **$method $path** — $desc

## Project context (auto-detected)
- Stack hint: !`cat package.json 2>/dev/null | grep -E '"(express|fastify|koa|next|vitest|jest)"' || echo "no package.json or unknown stack"`
- Existing routes: !`ls src/routes 2>/dev/null || ls routes 2>/dev/null || echo "no routes dir yet"`

## Your task
Produce the "四件套" (four files) for the endpoint above.

1. Derive `{{NAME}}` from `$path`: take the last non-param segment, drop a trailing `/:id`, convert to camelCase (e.g. `/api/users/:id` → `users`; `/api/orders/:id/items` → `orderItems`).
2. Lowercase `$method` for the router call (`{{METHOD_LOWER}}`).
3. Read each template file and fill the placeholders, then write the result:
   - templates/route.tpl   → src/routes/{{NAME}}.js
   - templates/handler.tpl → src/handlers/{{NAME}}.js
   - templates/test.tpl    → tests/{{NAME}}.test.js
   - templates/doc.tpl     → docs/{{NAME}}.md
4. If `src/routes/index.js` (or equivalent registry) exists, append a registration import for the new route.
5. Print a one-line summary: which files were created and a suggested next command.

Keep generated code minimal and idiomatic to the detected stack. When the stack is unknown, default to plain Express-style handlers and note the assumption in the doc file.

## Resources
- For one worked example of input→output, read [examples/one-liner-to-files.md](examples/one-liner-to-files.md)
- Templates live in [templates/](templates/) — read them on demand, do not assume their contents.

# Input
/endpoint-scaffold POST /api/orders 创建订单

# Derived
NAME = orders
METHOD_LOWER = post

# Output files
- src/routes/orders.js
- src/handlers/orders.js
- tests/orders.test.js
- docs/orders.md

# Sample handler (filled)
export async function ordersHandler(req, res) {
  try {
    res.status(501).json({ error: 'not implemented' });
  } catch (err) {
    res.status(500).json({ error: String(err) });
  }
}

claude

/endpoint-scaffold POST /users 注册新用户

帮我加个接口：GET /products 列出所有商品，要带测试和文档

npx vitest run tests/users.test.js

/plugin install skill-creator@claude-plugins-official

/endpoint-scaffold POST   /api/orders         创建订单
/endpoint-scaffold GET    /api/orders/:id     查询订单详情
/endpoint-scaffold PATCH  /api/orders/:id     更新订单状态
/endpoint-scaffold DELETE /api/orders/:id     取消订单
/endpoint-scaffold GET    /api/products       商品列表

flowchart TD
    A["用户输入<br/>/endpoint-scaffold POST /users 注册新用户"] --> B{"Claude Code<br/>匹配 description/when_to_use"}
    B -->|命中| C["frontmatter 解析<br/>arguments: method path desc"]
    C --> D["动态注入预执行<br/>!`cat package.json` → 真实栈<br/>!`ls src/routes` → 已有路由"]
    D --> E["SKILL.md 正文进入会话<br/>模板文件尚未加载"]
    E --> F["Claude 执行步骤1-2<br/>派生 NAME / METHOD_LOWER"]
    F --> G["按需 Read templates/*.tpl<br/>渐进式披露: 只读需要的文件"]
    G --> H["Write 四件套<br/>route/handler/test/doc"]
    H --> I["注册路由 + 输出总结"]
    I --> J["基线对照迭代<br/>skill-creator 跑 benchmark.json"]
    B -->|未命中| K["降级为普通对话<br/>或检查 description 触发短语"]