# ๐ง ๆบ่ฝ็บฆๆ็ณป็ปๆถๆ่ฎพ่ฎก
## ๐ ็ณป็ปๆฆ่ฟฐ
ๆบ่ฝ็บฆๆ็ณป็ปไธบMCPๆฅๅฃ้ช่ฏ็ปไปถๆทปๅ ไบ`.use interface`ๆไปคๅ่ฝ๏ผ่ฝๅค่ชๅจๆฆๆช็จๆท่พๅ
ฅๅนถๆณจๅ
ฅๆฅๅฃ้ช่ฏ็บฆๆๆ็คบ่ฏ๏ผ็กฎไฟAI็ๆ็ฌฆๅOpenAPI่ง่็้ซ่ดจ้ไปฃ็ ใ
## ๐๏ธ ๆ ธๅฟๆถๆ
### 1. ็ณป็ป็ปไปถๅพ
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆบ่ฝ็บฆๆ็ณป็ป โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ ๆไปคๆฃๆตๅจ โ โ ็บฆๆ็ฎก็ๅจ โ โ ๆจกๆฟๅผๆ โ โ
โ โ InstructionDet โ โ ConstraintMgr โ โ TemplateEngine โ โ
โ โ ector โ โ โ โ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ ๆไปคๅขๅผบๅจ โ โ ไธไธๆๆณจๅ
ฅๅจ โ โ ไผ่ฏ็ฎก็ๅจ โ โ
โ โ InstructionEnh โ โ ContextInjector โ โ SessionManager โ โ
โ โ ancer โ โ โ โ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MCPๅทฅๅ
ทๆฅๅฃ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โข activate-interface-constraints โ
โ โข apply-interface-constraints โ
โ โข validate-interface (ๅขๅผบ็) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
### 2. ๆฐๆฎๆต็จๅพ
```
็จๆท่พๅ
ฅ: ".use interface ๅผๅ่ๅคฉๅ่ฝ"
โ
โผ
โโโโโโโโโโโโโโโโโโโ
โ ๆไปคๆฃๆตๅจ โ โโโโ ๆฃๆต .use interface
โโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโ
โ ็บฆๆ็ฎก็ๅจ โ โโโโ ๆฟๆดป็บฆๆๆจกๅผ
โโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโ
โ ๆจกๆฟๅผๆ โ โโโโ ็ๆ็บฆๆๆ็คบ่ฏ
โโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโ
โ ๆไปคๅขๅผบๅจ โ โโโโ ๅๅนถ็จๆทๆไปค+็บฆๆ
โโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโ
โ ่ฟๅๅขๅผบๆไปค โ โโโโ ไพ็จๆทไฝฟ็จ
โโโโโโโโโโโโโโโโโโโ
```
## ๐ง ๆ ธๅฟ็ปไปถ่ฎพ่ฎก
### 1. InstructionDetector (ๆไปคๆฃๆตๅจ)
**่่ดฃ**๏ผ
- ๆฃๆต็จๆท่พๅ
ฅไธญ็ `.use interface` ๆไปค
- ๆฏๆไธญ่ฑๆๆไปคๅไฝ
- ๆๅ็จๆท็ๅฎ้
้ๆฑๅ
ๅฎน
**ๆฅๅฃ่ฎพ่ฎก**๏ผ
```typescript
interface InstructionDetector {
detectConstraintCommand(input: string): ConstraintCommand | null;
extractUserInstruction(input: string): string;
getSupportedCommands(): string[];
}
interface ConstraintCommand {
command: string; // ".use interface"
userInstruction: string; // "ๅผๅ่ๅคฉๅ่ฝ"
options?: any; // ๅฏ้ๅๆฐ
}
```
### 2. ConstraintManager (็บฆๆ็ฎก็ๅจ)
**่่ดฃ**๏ผ
- ็ฎก็็บฆๆๆจกๅผ็ๆฟๆดป็ถๆ
- ็ปดๆคไผ่ฏ็บงๅซ็็บฆๆ้
็ฝฎ
- ๆไพ็บฆๆ็ถๆๆฅ่ฏขๅๆงๅถ
**ๆฅๅฃ่ฎพ่ฎก**๏ผ
```typescript
interface ConstraintManager {
activateConstraints(sessionId: string, config?: ConstraintConfig): void;
deactivateConstraints(sessionId: string): void;
isConstraintActive(sessionId: string): boolean;
getConstraintConfig(sessionId: string): ConstraintConfig | null;
updateConstraintConfig(sessionId: string, config: ConstraintConfig): void;
}
interface ConstraintConfig {
templateType: 'default' | 'strict' | 'custom';
language: 'zh' | 'en' | 'auto';
includeProjectContext: boolean;
customRules?: string[];
}
```
### 3. ConstraintTemplateEngine (็บฆๆๆจกๆฟๅผๆ)
**่่ดฃ**๏ผ
- ็ๆ็บฆๆๆ็คบ่ฏๆจกๆฟ
- ๆฏๆ้กน็ฎไธไธๆๆณจๅ
ฅ
- ๆไพๅค่ฏญ่จๆจกๆฟๆฏๆ
**ๆฅๅฃ่ฎพ่ฎก**๏ผ
```typescript
interface ConstraintTemplateEngine {
generateConstraintPrompt(
userIntent: UserIntent,
projectContext: ProjectContext,
config: ConstraintConfig
): string;
getAvailableTemplates(): TemplateInfo[];
registerCustomTemplate(name: string, template: ConstraintTemplate): void;
}
interface ConstraintTemplate {
name: string;
language: 'zh' | 'en';
content: string;
variables: string[];
priority: number;
}
```
### 4. InstructionEnhancer (ๆไปคๅขๅผบๅจ)
**่่ดฃ**๏ผ
- ๅๆ็จๆทๆไปคๆๅพ
- ๅๅนถ็จๆทๆไปคๅ็บฆๆๆ็คบ่ฏ
- ็ๆๆ็ป็ๅขๅผบๆไปค
**ๆฅๅฃ่ฎพ่ฎก**๏ผ
```typescript
interface InstructionEnhancer {
enhanceInstruction(
userInstruction: string,
constraintPrompt: string,
options?: EnhanceOptions
): EnhancedInstruction;
analyzeUserIntent(instruction: string): UserIntent;
formatEnhancedInstruction(instruction: EnhancedInstruction): string;
}
interface EnhancedInstruction {
originalInstruction: string;
constraintPrompt: string;
enhancedInstruction: string;
metadata: {
userIntent: UserIntent;
appliedConstraints: string[];
confidence: number;
};
}
```
## ๐ฏ ็บฆๆๆ็คบ่ฏๆจกๆฟ่ฎพ่ฎก
### 1. ๅบ็ก็บฆๆๆจกๆฟ (ไธญๆ)
```
๐ ๆฅๅฃๅผๅ็บฆๆ่ฆๆฑ๏ผ
1. **ไธฅๆ ผ้ตๅพชOpenAPI 3.0่ง่**
- ๆๆAPI็ซฏ็นๅฟ
้กป็ฌฆๅ็ฐๆ่ง่
- ๆฐๅข็ซฏ็นๅฟ
้กป้ตๅพช็ฐๆๅฝๅ็บฆๅฎ
- ๅฟ
้กปๅ
ๅซๅฎๆด็่ฏทๆฑ/ๅๅบๅฎไน
2. **ไปฃ็ ่ดจ้่ฆๆฑ**
- ๅฟ
้กปๅ
ๅซๅฎๆด็TypeScript็ฑปๅๅฎไน
- ๅฟ
้กปๅฎ็ฐ้ๅฝ็้่ฏฏๅค็ๆบๅถ
- ๅฟ
้กปๅ
ๅซ่พๅ
ฅ้ช่ฏๅๅฎๅ
จๆฃๆฅ
3. **้กน็ฎไธไธๆ็บฆๆ**
- APIๅบ็ก่ทฏๅพ: {basePath}
- ่ฎค่ฏๆนๅผ: {authMethod}
- ้็จๅๅบๆ ผๅผ: {responseFormat}
4. **ๆไฝณๅฎ่ทต่ฆๆฑ**
- ้ตๅพชRESTful่ฎพ่ฎกๅๅ
- ไฝฟ็จๆ ๅHTTP็ถๆ็
- ๅฎ็ฐ้ๅฝ็้่ฏฏๅๅบๆ ผๅผ
่ฏทๅบไบไปฅไธ็บฆๆ่ฆๆฑๅฎๆๅผๅไปปๅกใ
```
### 2. ไธฅๆ ผ็บฆๆๆจกๆฟ (่ฑๆ)
```
๐ STRICT INTERFACE DEVELOPMENT CONSTRAINTS:
1. **MANDATORY OpenAPI 3.0 Compliance**
- ALL endpoints MUST conform to existing specifications
- NEW endpoints MUST follow established naming conventions
- COMPLETE request/response definitions REQUIRED
2. **CODE QUALITY REQUIREMENTS**
- COMPLETE TypeScript type definitions MANDATORY
- PROPER error handling implementation REQUIRED
- INPUT validation and security checks ESSENTIAL
3. **PROJECT CONTEXT CONSTRAINTS**
- API Base Path: {basePath}
- Authentication: {authMethod}
- Response Format: {responseFormat}
4. **BEST PRACTICES ENFORCEMENT**
- RESTful design principles MANDATORY
- Standard HTTP status codes REQUIRED
- Proper error response format ESSENTIAL
STRICTLY ADHERE to these constraints while completing the development task.
```
## ๐ ๅทฅไฝๆต็จ่ฎพ่ฎก
### 1. ๆไปคๆฟๆดปๆต็จ
```
1. ็จๆท่พๅ
ฅ: ".use interface ๅผๅ่ๅคฉๅ่ฝ"
2. InstructionDetector ๆฃๆตๅฐ็บฆๆๆไปค
3. ConstraintManager ๆฟๆดป็บฆๆๆจกๅผ
4. ๆๅ็จๆทๆไปค: "ๅผๅ่ๅคฉๅ่ฝ"
5. ่ฟๅ็กฎ่ฎคไฟกๆฏๅๅ็ปญๆๅฏผ
```
### 2. ็บฆๆๅบ็จๆต็จ
```
1. ็จๆท่ฐ็จ apply-interface-constraints ๅทฅๅ
ท
2. InstructionEnhancer ๅๆ็จๆทๆๅพ
3. ConstraintTemplateEngine ็ๆ็บฆๆๆ็คบ่ฏ
4. ๅๅนถ็จๆทๆไปคๅ็บฆๆๆ็คบ่ฏ
5. ่ฟๅๅฎๆด็ๅขๅผบๆไปค
```
### 3. ๆบ่ฝ้ช่ฏๆต็จ
```
1. ็จๆท่ฐ็จ validate-interface ๅทฅๅ
ท
2. ๆฃๆฅๆฏๅฆๅคไบ็บฆๆๆจกๅผ
3. ๅฆๆๆฏ๏ผ่ชๅจๅบ็จ็บฆๆๅขๅผบ
4. ๆง่กๆ ๅ้ช่ฏๆต็จ
5. ่ฟๅ็บฆๆๆ็ฅ็้ช่ฏ็ปๆ
```
## ๐ ้
็ฝฎ็ณป็ป่ฎพ่ฎก
### 1. ๅ
จๅฑ้
็ฝฎ
```typescript
interface GlobalConstraintConfig {
defaultLanguage: 'zh' | 'en' | 'auto';
defaultTemplateType: 'default' | 'strict' | 'custom';
enableAutoDetection: boolean;
maxSessionDuration: number;
supportedCommands: string[];
}
```
### 2. ้กน็ฎ้
็ฝฎ
```typescript
interface ProjectConstraintConfig {
apiBasePath: string;
authenticationMethod: string;
responseFormat: any;
customConstraints: string[];
excludedPaths: string[];
strictMode: boolean;
}
```
## ๐ MCPๅทฅๅ
ทๆฅๅฃ่ฎพ่ฎก
### 1. activate-interface-constraints
```json
{
"name": "activate-interface-constraints",
"description": "ๆฟๆดปๆฅๅฃ็บฆๆๆจกๅผ",
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": ["activate", "deactivate", "status"],
"description": "็บฆๆๆจกๅผๆไฝ"
},
"config": {
"type": "object",
"description": "็บฆๆ้
็ฝฎ้้กน"
}
}
}
}
```
### 2. apply-interface-constraints
```json
{
"name": "apply-interface-constraints",
"description": "ๅบ็จๆฅๅฃ็บฆๆๅฐ็จๆทๆไปค",
"inputSchema": {
"type": "object",
"properties": {
"userInstruction": {
"type": "string",
"description": "็จๆทๅๅงๆไปค"
},
"constraintType": {
"type": "string",
"enum": ["default", "strict", "custom"],
"description": "็บฆๆ็ฑปๅ"
},
"projectContext": {
"type": "object",
"description": "้กน็ฎไธไธๆไฟกๆฏ"
}
},
"required": ["userInstruction"]
}
}
```
## ๐ฏ ้ขๆๆๆ
1. **็จๆทไฝ้ช**๏ผ
- ็ฎๅ็ `.use interface` ๆไปคๅณๅฏๆฟๆดป็บฆๆ
- ่ชๅจ็ๆ็ฌฆๅ่ง่็ๅขๅผบๆไปค
- ๆ ้ๆๅจ้
็ฝฎๅคๆ็็บฆๆ่งๅ
2. **ไปฃ็ ่ดจ้**๏ผ
- ็กฎไฟAI็ๆ็ไปฃ็ ็ฌฆๅOpenAPI่ง่
- ่ชๅจๅ
ๅซ็ฑปๅๅฎๅ
จๅ้่ฏฏๅค็
- ้ตๅพช้กน็ฎ็นๅฎ็ๆฅๅฃ็บฆๅฎ
3. **ๅผๅๆ็**๏ผ
- ๅๅฐๆฅๅฃไธๅน้
็้ฎ้ข
- ๆไพๆบ่ฝ็ๅผๅๆๅฏผ
- ๆฏๆๆจก็ณๆไปค็็ฒพ็กฎๅค็
่ฟไธชๆถๆ่ฎพ่ฎกไธบๅฎ็ฐๆบ่ฝ็บฆๆ็ณป็ปๆไพไบๆธ
ๆฐ็ๆๆฏ่ทฏ็บฟๅพใ
