mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-14 02:42:04 +08:00
feat: Enhance documentation diagnosis and category mapping
- Introduced action to diagnose documentation structure, identifying redundancies and conflicts. - Added centralized category mappings in JSON format for improved detection and strategy application. - Updated existing functions to utilize new mappings for taxonomy and strategy matching. - Implemented new detection patterns for documentation redundancy and conflict. - Expanded state schema to include documentation diagnosis results. - Enhanced severity criteria and strategy selection guide to accommodate new documentation issues.
This commit is contained in:
catlog22
263
.claude/skills/skill-tuning/specs/category-mappings.json
Normal file
263
.claude/skills/skill-tuning/specs/category-mappings.json
Normal file
@@ -0,0 +1,263 @@
|
||||
{
|
||||
"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]
|
||||
}
|
||||
},
|
||||
"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"
|
||||
},
|
||||
"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"
|
||||
}
|
||||
},
|
||||
"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",
|
||||
"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",
|
||||
"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",
|
||||
"custom": "Requires custom analysis"
|
||||
},
|
||||
"fix_priority_order": {
|
||||
"P0": ["dataflow_break", "authoring_principles_violation"],
|
||||
"P1": ["agent_failure"],
|
||||
"P2": ["context_explosion"],
|
||||
"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
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user