Content Simplifier

---
name: content-simplifier
description: 精简 skill / rules 文件内容：识别冗余、重复、过时内容，提升决策清晰度与上下文利用效率。触发："精简 skill"、"简化内容"、"压缩文件"、"清理冗余"、"文件过长"。系统优化分析走 artifact-optimizer，修改前质疑走 request-guard。
---

# 内容精简指导

## 何时使用

当出现以下情况时使用本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. 验证回滚结果

## 配置选项

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

### 策略配置
```yaml
# 配置精简策略
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. **持续改进**：根据反馈持续优化精简策略