mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-11 02:33:51 +08:00
f14418603a
重构 ccw cli 模板系统： - 新增 template-discovery.ts 模块，支持扁平化模板自动发现 - 添加 --rule <template> 选项，自动加载 protocol 和 template - 模板目录从嵌套结构 (prompts/category/file.txt) 迁移到扁平结构 (prompts/category-function.txt) - 更新所有 agent/command 文件，使用 $PROTO $TMPL 环境变量替代 $(cat ...) 模式 - 支持模糊匹配：--rule 02-review-architecture 可匹配 analysis-review-architecture.txt 其他更新： - Dashboard: 添加 Claude Manager 和 Issue Manager 页面 - Codex-lens: 增强 chain_search 和 clustering 模块 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
123 lines
1.9 KiB
Plaintext
123 lines
1.9 KiB
Plaintext
# Rule Template: API Rules (Backend/Fullstack Only)
|
|
|
|
## Variables
|
|
- {TECH_STACK_NAME}: Tech stack display name
|
|
- {FILE_EXT}: File extension pattern
|
|
- {API_FRAMEWORK}: API framework (Express, FastAPI, etc)
|
|
|
|
## Output Format
|
|
|
|
```markdown
|
|
---
|
|
paths:
|
|
- "**/api/**/*.{FILE_EXT}"
|
|
- "**/routes/**/*.{FILE_EXT}"
|
|
- "**/endpoints/**/*.{FILE_EXT}"
|
|
- "**/controllers/**/*.{FILE_EXT}"
|
|
- "**/handlers/**/*.{FILE_EXT}"
|
|
---
|
|
|
|
# {TECH_STACK_NAME} API Rules
|
|
|
|
## Endpoint Design
|
|
|
|
[REST/GraphQL conventions from Exa research]
|
|
|
|
### URL Structure
|
|
- Resource naming (plural nouns)
|
|
- Nesting depth limits
|
|
- Query parameter conventions
|
|
- Version prefixing
|
|
|
|
### HTTP Methods
|
|
- GET: Read operations
|
|
- POST: Create operations
|
|
- PUT/PATCH: Update operations
|
|
- DELETE: Remove operations
|
|
|
|
### Status Codes
|
|
- 2xx: Success responses
|
|
- 4xx: Client errors
|
|
- 5xx: Server errors
|
|
|
|
## Request Validation
|
|
|
|
[Input validation patterns]
|
|
|
|
### Schema Validation
|
|
```{lang}
|
|
// Example validation schema
|
|
```
|
|
|
|
### Required Fields
|
|
- Validation approach
|
|
- Error messages format
|
|
- Sanitization rules
|
|
|
|
## Response Format
|
|
|
|
[Standard response structures]
|
|
|
|
### Success Response
|
|
```json
|
|
{
|
|
"data": {},
|
|
"meta": {}
|
|
}
|
|
```
|
|
|
|
### Pagination
|
|
```json
|
|
{
|
|
"data": [],
|
|
"pagination": {
|
|
"page": 1,
|
|
"limit": 20,
|
|
"total": 100
|
|
}
|
|
}
|
|
```
|
|
|
|
## Error Responses
|
|
|
|
[Error handling for APIs]
|
|
|
|
### Error Format
|
|
```json
|
|
{
|
|
"error": {
|
|
"code": "ERROR_CODE",
|
|
"message": "Human readable message",
|
|
"details": {}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Common Error Codes
|
|
- VALIDATION_ERROR
|
|
- NOT_FOUND
|
|
- UNAUTHORIZED
|
|
- FORBIDDEN
|
|
|
|
## Authentication & Authorization
|
|
|
|
[Auth patterns]
|
|
- Token handling
|
|
- Permission checks
|
|
- Rate limiting
|
|
|
|
## Documentation
|
|
|
|
[API documentation standards]
|
|
- OpenAPI/Swagger
|
|
- Inline documentation
|
|
- Example requests/responses
|
|
```
|
|
|
|
## Content Guidelines
|
|
|
|
- Focus on API-specific patterns
|
|
- Include request/response examples
|
|
- Cover security considerations
|
|
- Reference framework conventions
|