Skip to content

refactor: 拆分 SKILL.md 为模块化 references 结构#24

Open
IA20201 wants to merge 2 commits into
op7418:mainfrom
IA20201:main
Open

refactor: 拆分 SKILL.md 为模块化 references 结构#24
IA20201 wants to merge 2 commits into
op7418:mainfrom
IA20201:main

Conversation

@IA20201

@IA20201 IA20201 commented Jun 1, 2026

Copy link
Copy Markdown

背景

当前 SKILL.md 将 24 个 AI 写作模式、核心规则、处理流程、质量评分、完整示例全部堆在一个文件中(~19KB/300+ 行)。Agent 加载时需要读取整个文件,占用大量上下文窗口。

改动

将 SKILL.md 拆分为模块化结构,agent 按需加载:

SKILL.md                           (2.6KB, ~70行)
├── references/
│   ├── content-patterns.md        (模式 1-6: 内容层面)
│   ├── language-patterns.md       (模式 7-12: 语言/语法层面)
│   ├── style-patterns.md          (模式 13-18: 风格/排版层面)
│   ├── communication-patterns.md  (模式 19-24: 交流/填充层面)
│   └── scoring.md                 (质量评分 + 个性注入 + 示例)
└── README.md                      (更新结构描述)

SKILL.md(主文件)

  • 保留核心规则(5条)、快速检查清单(6项)、处理流程(6步)
  • 参考文件列表添加触发条件,引导 agent 只读取对应的文件
  • 末尾添加使用示例

references/(参考文件)

  • 24 个模式按 4 个类别拆分,每个文件格式统一:触发词 → 问题描述 → 改写前/后
  • scoring.md 独立封装评分表和个性注入指南

README.md

  • 保留原仓库的多种安装方法(npx / git clone / 手动)
  • 更新文件结构说明、模式总览表

动机

  • Agent Skill 设计最佳实践建议 SKILL.md 控制在 ~500 行以内,长内容拆到 references/ 按需加载
  • 模块化后 agent 可以根据文本特征只读取相关类别的模式文件,减少上下文占用
  • 维护更方便:修改某个类别的模式不影响其他文件

验证

  • 通过 validate_skill.py 验证
  • 参考文件格式统一,无重复内容

IA20201 added 2 commits June 1, 2026 16:58
- SKILL.md 精简至 ~55 行,只保留核心规则、快速检查和处理流程
- 24 个 AI 写作模式按类别拆分到 references/ 目录:
  - content-patterns.md (模式 1-6): 内容层面
  - language-patterns.md (模式 7-12): 语言/语法层面
  - style-patterns.md (模式 13-18): 风格/排版层面
  - communication-patterns.md (模式 19-24): 交流/填充层面
  - scoring.md: 质量评分 + 个性注入指南 + 完整示例
- README.md 更新以反映新结构
- 参考文件列表添加触发条件,引导 agent 按需加载
- 处理流程第 4 步改为引用核心规则+快速检查,避免重叠
- 末尾添加使用示例(输入/输出对比)
- 模式 3 添加分类归属注释(语言结构但归入内容模式的原因)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant