内容精简指导

何时使用

当出现以下情况时使用本skill：

• skill文件超过500行，需要精简
• rules文件内容冗长，需要优化
• AI响应变慢，怀疑是上下文过大导致
• 用户明确要求精简或优化文件内容
• 决策流程模糊，需要优化清晰度

核心目标

本skill指导AI如何精简skill和rules文件，而不是提供一个独立的工具。AI需要根据以下指导原则，手动分析和精简文件内容。

分策略精简

不同类型的文件采用不同的精简策略，确保精简后保留关键规范：

文件类型	精简策略	保留要求
Skill 文件	保留 AI 说明层，精简正文内容	必须保留：目的、功能、使用场景
Rules 文件	保留规则结构，精简冗余规则	必须保留：规则分类、优先级
普通文档	通用精简策略	必须保留：核心内容、逻辑结构

1. Skill文件精简

针对skill文件，采用以下策略：

必须保留的 AI 说明层：

• 目的：这个技能要解决什么问题或完成什么任务
• 功能：这个技能能做什么，提供哪些能力
• 使用场景：何时应该使用此技能，列出具体触发场景

识别冗余内容：

• 重复的解释说明
• 过多的示例（保留关键示例）
• 过时的信息
• 冗长的背景介绍

优化决策流程：

• 模糊的条件判断
• 不清晰的分支逻辑
• 过多的嵌套层级

保留核心内容：

• 关键功能描述
• 重要步骤说明
• 核心原则
• 必要的示例

2. Rules文件精简

针对rules文件，采用以下策略：

识别冗余规则：

• 重复的规则
• 过时的规则
• 不清晰的规则表述

优化规则结构：

• 规则分类整理
• 规则优先级明确
• 规则冲突解决

保留核心规则：

• 关键业务规则
• 安全相关规则
• 性能相关规则

精简流程

第一步：文件类型识别与分析

AI需要先识别文件类型，再进行针对性分析：

文件类型识别：

• Skill 文件：路径包含 skills/ 且文件名为 SKILL.md
• Rules 文件：路径包含 rules/ 且扩展名为 .md
• 普通文档：其他 Markdown 文件

针对性分析：

• 文件总行数
• 冗余内容识别
• 决策流程分析
• 精简建议
• Skill 文件特殊检查：是否包含 AI 说明层（目的、功能、使用场景）

第二步：生成精简方案

基于分析结果，生成精简方案：

• 删除冗余内容
• 优化决策流程
• 整理结构
• 保留核心内容

第三步：用户确认

显示精简方案，等待用户确认：

• 显示将删除的内容
• 显示优化建议
• 显示预期效果

第四步：执行精简

用户确认后，执行精简：

• 自动备份原文件
• 执行精简操作
• 生成精简后文件

第五步：验证结果

验证精简效果：

• 检查文件完整性
• 验证核心内容保留
• 测试功能正常

使用示例

示例1：精简skill文件

AI可以精简单个skill文件：

1. 读取skill文件内容
2. 分析冗余内容
3. 生成精简方案
4. 用户确认后执行精简

示例2：精简rules文件

AI可以精简单个rules文件：

1. 读取rules文件内容
2. 分析冗余规则
3. 生成精简方案
4. 用户确认后执行精简

示例3：分析文件

AI可以分析文件，不执行精简：

1. 读取文件内容
2. 分析冗余内容
3. 生成分析报告
4. 提供精简建议

示例4：处理超大文件

AI可以处理超大文件（超过1000行）：

1. 分析文件结构
2. 识别主要部分
3. 分批处理每个部分
4. 合并精简结果

示例5：处理格式异常文件

AI可以处理格式异常文件：

1. 识别格式问题
2. 修复格式错误
3. 执行精简操作
4. 验证修复效果

精简效果指标

目标效果

• 文件长度减少20%-50%
• 核心内容完整保留
• 决策流程清晰度提升
• AI响应速度提升

验证标准

• 精简后文件可读性良好
• 核心功能不受影响
• 决策流程清晰明确
• 用户满意度提升

识别模糊决策

• 条件判断不清晰
• 分支逻辑复杂
• 嵌套层级过多

优化建议

• 简化条件表达式
• 减少嵌套层级
• 明确分支逻辑
• 添加决策说明

验证标准

• 决策路径清晰
• 分支逻辑明确
• 条件表达式简洁
• 易于理解和维护

批量处理

批量精简

AI可以批量精简文件：

1. 识别所有需要精简的文件
2. 逐个分析每个文件
3. 生成批量精简方案
4. 用户确认后执行批量精简

批量回滚

AI可以批量回滚文件：

1. 识别所有需要回滚的文件
2. 逐个回滚每个文件
3. 验证回滚结果

配置选项

精简比例配置

# 配置精简比例
simplification_ratio: 0.3  # 精简30%

策略配置

# 配置精简策略
strategies:
  skill:
    - preserve_ai_layer  # 必须保留 AI 说明层（目的、功能、使用场景）
    - remove_redundancy
    - optimize_examples
    - simplify_decision_flow
  rules:
    - remove_duplicate_rules
    - clarify_ambiguous_rules
    - organize_structure
  general:
    - remove_redundancy
    - simplify_structure
    - improve_readability

注意事项

1. 核心内容保留：精简时必须保留核心功能描述和关键步骤
2. 决策流程清晰：优化决策流程，确保逻辑清晰明确
3. 用户确认：精简前必须获得用户确认
4. 备份机制：精简前必须自动备份原文件
5. 回滚支持：必须支持一键回滚到原始状态
6. 超大文件处理：文件超过1000行时，建议分批处理
7. 格式异常处理：文件格式异常时，先修复格式再精简
8. AI 说明层保留：精简 Skill 文件时，必须保留 AI 说明层（目的、功能、使用场景），如缺失则自动补充

错误处理

常见错误

• 文件不存在：提示用户检查文件路径
• 文件格式错误：提示用户检查文件格式
• 精简失败：提供错误原因和解决方案
• 回滚失败：提供恢复机制

错误恢复

• 精简失败：自动回滚到备份状态
• 回滚失败：提供手动恢复指导
• 数据丢失：从备份中恢复

最佳实践

1. 定期精简：定期检查和精简skill/rules文件
2. 渐进优化：逐步优化，避免一次性大幅修改
3. 用户参与：重要修改前与用户确认
4. 效果验证：精简后验证效果，确保质量
5. 持续改进：根据反馈持续优化精简策略