Files
Claude-Code-Workflow/.claude/skills/skill-tuning/specs/category-mappings.json

285 lines
11 KiB
JSON

{
"version": "1.0.0",
"description": "Centralized category mappings for skill-tuning analysis and fix proposal",
"categories": {
"authoring_principles_violation": {
"pattern_ids": ["APV-001", "APV-002", "APV-003", "APV-004", "APV-005", "APV-006"],
"severity_hint": "critical",
"strategies": ["eliminate_intermediate_files", "minimize_state", "context_passing"],
"risk_levels": ["low", "low", "low"],
"detection_focus": "Intermediate files, state bloat, file relay patterns",
"priority_order": [1, 2, 3]
},
"context_explosion": {
"pattern_ids": ["CTX-001", "CTX-002", "CTX-003", "CTX-004", "CTX-005"],
"severity_hint": "high",
"strategies": ["sliding_window", "path_reference", "context_summarization", "structured_state"],
"risk_levels": ["low", "low", "low", "medium"],
"detection_focus": "Token accumulation, content passing patterns",
"priority_order": [1, 2, 3, 4]
},
"memory_loss": {
"pattern_ids": ["MEM-001", "MEM-002", "MEM-003", "MEM-004", "MEM-005"],
"severity_hint": "high",
"strategies": ["constraint_injection", "state_constraints_field", "checkpoint_restore", "goal_embedding"],
"risk_levels": ["low", "low", "low", "medium"],
"detection_focus": "Constraint propagation, checkpoint mechanisms",
"priority_order": [1, 2, 3, 4]
},
"dataflow_break": {
"pattern_ids": ["DF-001", "DF-002", "DF-003", "DF-004", "DF-005"],
"severity_hint": "critical",
"strategies": ["state_centralization", "schema_enforcement", "field_normalization"],
"risk_levels": ["medium", "low", "low"],
"detection_focus": "State storage, schema validation",
"priority_order": [1, 2, 3]
},
"agent_failure": {
"pattern_ids": ["AGT-001", "AGT-002", "AGT-003", "AGT-004", "AGT-005", "AGT-006"],
"severity_hint": "high",
"strategies": ["error_wrapping", "result_validation", "flatten_nesting"],
"risk_levels": ["low", "low", "medium"],
"detection_focus": "Error handling, result validation",
"priority_order": [1, 2, 3]
},
"prompt_quality": {
"pattern_ids": [],
"severity_hint": "medium",
"strategies": ["structured_prompt", "output_schema", "grounding_context", "format_enforcement"],
"risk_levels": ["low", "low", "medium", "low"],
"detection_focus": null,
"needs_gemini_analysis": true,
"priority_order": [1, 2, 3, 4]
},
"architecture": {
"pattern_ids": [],
"severity_hint": "medium",
"strategies": ["phase_decomposition", "interface_contracts", "plugin_architecture", "state_machine"],
"risk_levels": ["medium", "medium", "high", "medium"],
"detection_focus": null,
"needs_gemini_analysis": true,
"priority_order": [1, 2, 3, 4]
},
"performance": {
"pattern_ids": ["CTX-001", "CTX-003"],
"severity_hint": "medium",
"strategies": ["token_budgeting", "parallel_execution", "result_caching", "lazy_loading"],
"risk_levels": ["low", "low", "low", "low"],
"detection_focus": "Reuses context explosion detection",
"priority_order": [1, 2, 3, 4]
},
"error_handling": {
"pattern_ids": ["AGT-001", "AGT-002"],
"severity_hint": "medium",
"strategies": ["graceful_degradation", "error_propagation", "structured_logging", "error_context"],
"risk_levels": ["low", "low", "low", "low"],
"detection_focus": "Reuses agent failure detection",
"priority_order": [1, 2, 3, 4]
},
"output_quality": {
"pattern_ids": [],
"severity_hint": "medium",
"strategies": ["quality_gates", "output_validation", "template_enforcement", "completeness_check"],
"risk_levels": ["low", "low", "low", "low"],
"detection_focus": null,
"needs_gemini_analysis": true,
"priority_order": [1, 2, 3, 4]
},
"user_experience": {
"pattern_ids": [],
"severity_hint": "low",
"strategies": ["progress_tracking", "status_communication", "interactive_checkpoints", "guided_workflow"],
"risk_levels": ["low", "low", "low", "low"],
"detection_focus": null,
"needs_gemini_analysis": true,
"priority_order": [1, 2, 3, 4]
},
"token_consumption": {
"pattern_ids": ["TKN-001", "TKN-002", "TKN-003", "TKN-004", "TKN-005"],
"severity_hint": "medium",
"strategies": ["prompt_compression", "lazy_loading", "output_minimization", "state_field_reduction", "sliding_window"],
"risk_levels": ["low", "low", "low", "low", "low"],
"detection_focus": "Verbose prompts, excessive state fields, full content passing, unbounded arrays, redundant I/O",
"priority_order": [1, 2, 3, 4, 5]
}
},
"keywords": {
"chinese": {
"token": "context_explosion",
"上下文": "context_explosion",
"爆炸": "context_explosion",
"太长": "context_explosion",
"超限": "context_explosion",
"膨胀": "context_explosion",
"遗忘": "memory_loss",
"忘记": "memory_loss",
"指令丢失": "memory_loss",
"约束消失": "memory_loss",
"目标漂移": "memory_loss",
"状态": "dataflow_break",
"数据": "dataflow_break",
"格式": "dataflow_break",
"不一致": "dataflow_break",
"丢失": "dataflow_break",
"损坏": "dataflow_break",
"agent": "agent_failure",
"子任务": "agent_failure",
"失败": "agent_failure",
"嵌套": "agent_failure",
"调用": "agent_failure",
"协调": "agent_failure",
"慢": "performance",
"性能": "performance",
"效率": "performance",
"延迟": "performance",
"提示词": "prompt_quality",
"输出不稳定": "prompt_quality",
"幻觉": "prompt_quality",
"架构": "architecture",
"结构": "architecture",
"模块": "architecture",
"耦合": "architecture",
"扩展": "architecture",
"错误": "error_handling",
"异常": "error_handling",
"恢复": "error_handling",
"降级": "error_handling",
"崩溃": "error_handling",
"输出": "output_quality",
"质量": "output_quality",
"验证": "output_quality",
"不完整": "output_quality",
"交互": "user_experience",
"体验": "user_experience",
"进度": "user_experience",
"反馈": "user_experience",
"不清晰": "user_experience",
"中间文件": "authoring_principles_violation",
"临时文件": "authoring_principles_violation",
"文件中转": "authoring_principles_violation",
"state膨胀": "authoring_principles_violation",
"token消耗": "token_consumption",
"token优化": "token_consumption",
"产出简化": "token_consumption",
"冗长": "token_consumption",
"精简": "token_consumption"
},
"english": {
"token": "context_explosion",
"context": "context_explosion",
"explosion": "context_explosion",
"overflow": "context_explosion",
"bloat": "context_explosion",
"forget": "memory_loss",
"lost": "memory_loss",
"drift": "memory_loss",
"constraint": "memory_loss",
"goal": "memory_loss",
"state": "dataflow_break",
"data": "dataflow_break",
"format": "dataflow_break",
"inconsistent": "dataflow_break",
"corrupt": "dataflow_break",
"agent": "agent_failure",
"subtask": "agent_failure",
"fail": "agent_failure",
"nested": "agent_failure",
"call": "agent_failure",
"coordinate": "agent_failure",
"slow": "performance",
"performance": "performance",
"efficiency": "performance",
"latency": "performance",
"prompt": "prompt_quality",
"unstable": "prompt_quality",
"hallucination": "prompt_quality",
"architecture": "architecture",
"structure": "architecture",
"module": "architecture",
"coupling": "architecture",
"error": "error_handling",
"exception": "error_handling",
"recovery": "error_handling",
"crash": "error_handling",
"output": "output_quality",
"quality": "output_quality",
"validation": "output_quality",
"incomplete": "output_quality",
"interaction": "user_experience",
"ux": "user_experience",
"progress": "user_experience",
"feedback": "user_experience",
"intermediate": "authoring_principles_violation",
"temp": "authoring_principles_violation",
"relay": "authoring_principles_violation",
"verbose": "token_consumption",
"minimize": "token_consumption",
"compress": "token_consumption",
"simplify": "token_consumption",
"reduction": "token_consumption"
}
},
"category_labels": {
"context_explosion": "Context Explosion",
"memory_loss": "Long-tail Forgetting",
"dataflow_break": "Data Flow Disruption",
"agent_failure": "Agent Coordination Failure",
"prompt_quality": "Prompt Quality",
"architecture": "Architecture",
"performance": "Performance",
"error_handling": "Error Handling",
"output_quality": "Output Quality",
"user_experience": "User Experience",
"authoring_principles_violation": "Authoring Principles Violation",
"token_consumption": "Token Consumption",
"custom": "Custom"
},
"category_labels_chinese": {
"context_explosion": "Context Explosion",
"memory_loss": "Long-tail Forgetting",
"dataflow_break": "Data Flow Disruption",
"agent_failure": "Agent Coordination Failure",
"prompt_quality": "Prompt Quality",
"architecture": "Architecture Issues",
"performance": "Performance Issues",
"error_handling": "Error Handling",
"output_quality": "Output Quality",
"user_experience": "User Experience",
"authoring_principles_violation": "Authoring Principles Violation",
"token_consumption": "Token Consumption Optimization",
"custom": "Other Issues"
},
"category_descriptions": {
"context_explosion": "Token accumulation causing prompt size to grow unbounded",
"memory_loss": "Early instructions or constraints lost in later phases",
"dataflow_break": "State data inconsistency between phases",
"agent_failure": "Sub-agent call failures or abnormal results",
"prompt_quality": "Vague prompts causing unstable outputs",
"architecture": "Improper phase division or module structure",
"performance": "Slow execution or high token consumption",
"error_handling": "Incomplete error recovery mechanisms",
"output_quality": "Output validation or completeness issues",
"user_experience": "Interaction or feedback clarity issues",
"authoring_principles_violation": "Violation of skill authoring principles",
"token_consumption": "Excessive token usage from verbose prompts, large state objects, or redundant I/O patterns",
"custom": "Requires custom analysis"
},
"fix_priority_order": {
"P0": ["dataflow_break", "authoring_principles_violation"],
"P1": ["agent_failure"],
"P2": ["context_explosion", "token_consumption"],
"P3": ["memory_loss"]
},
"cross_category_dependencies": {
"context_explosion": ["memory_loss"],
"dataflow_break": ["agent_failure"],
"agent_failure": ["context_explosion"]
},
"fallback": {
"strategies": ["custom"],
"risk_levels": ["medium"],
"has_fix": true,
"needs_gemini_analysis": true
}
}