关于 ameliore-systeme
ameliore-systeme 是一项 Claude Code 技能,用于分析本地会话历史,并将反复出现的错误、指示、工作流和任务转化为具体改进建议。它面向希望依据对话证据改进 Claude Code 规则、创建技能或自动化重复工作的用户。
主要功能
- 01摘要指定时段的会话历史
- 02识别反复出现的错误与指示
- 03提出 CLAUDE.md 规则和技能
- 04为重复任务建议自动化方案
- 05历史记录仅在本地只读处理
适用场景
- 01查找多个会话中反复出现的 Claude Code 错误
- 02将重复的用户指示转化为项目规则
- 03根据重复的多步骤工作流设计技能
- 04识别适合自动化的重复任务
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ melvynx/ shared-skills --skill ameliore-systeme安装后在 Claude Code 中输入/ameliore-systeme确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdagents/openai.yamlassets/codex-icon.svgscripts/digest.mjs详细介绍
ameliore-systeme
每次 Claude Code 对话都会保存在用户的电脑上:每个会话对应 ~/.claude/projects/<folder>/ 中的一个 .jsonl 文件。这些历史记录会显示 Claude 哪里做错了、用户不得不重复说了什么,以及每天都要重做哪些工作。此技能会读取这些记录,并将其转化为改进措施。
用户在 /ameliore-systeme 后输入的内容:$ARGUMENTS(数字 = 要读取的天数,默认为 7)。
使用用户所用的语言回答(默认使用法语)。
1. 读取历史记录
运行此技能文件夹中的摘要脚本。它只会读取记录,并写入一个 Markdown 文件:
node <this skill folder>/scripts/digest.mjs --days <N> --out /tmp/ameliore-digest.md
然后完整阅读 /tmp/ameliore-digest.md。每个会话都包含其文件夹、日期、标题、使用过的斜杠命令、工具错误以及用户输入的每条消息。切勿逐个打开原始 .jsonl 文件:它们包含完整对话,会占满上下文。只有在核实某个具体细节时,才用 grep 打开一个文件。
如果摘要被截断(tronqué),请缩短天数后重新运行。
2. 报告
在聊天中撰写报告,包含以下 4 个部分。每个要点都必须引用历史记录:日期、文件夹和用户的原话。切勿提供历史记录中没有依据的泛泛建议。
- Ce que Claude fait mal:反复出现的错误(用户说「non」「pas ça」「je t'ai déjà dit」、重复提出同一个要求,或让 Claude 停下)。每项列出出现次数、2 条引述,以及对应的改进:一条可直接加入
CLAUDE.md的规则。 - Ce que tu répètes:用户在多个会话中反复提出的指示(风格、工具、检查事项)。每项都应整理成一条
CLAUDE.md规则或一个技能。 - Les skills à créer:反复执行的多步骤工作流。每项列出名称、用 3 行说明其功能,以及它来自哪些会话。
- Les tâches répétées à automatiser:每天或每周都会重复出现的任务(相同文件夹、相同类型的请求)。每项列出出现的日期和文件夹、目前需要的时间(这些会话中的消息数和工具数),以及适合实现自动化的方式:技能、脚本、计划任务或钩子。
最后列出最值得优先实施的 3 项改进,按节省时间的多少排序,并询问用户想先实现哪一项。
3. 实现用户选择的内容
CLAUDE.md规则:展示确切内容,然后在用户同意后将其添加到~/.claude/CLAUDE.md(适用于所有项目)或项目的CLAUDE.md(仅适用于一个项目)。切勿删除已有的行。- 技能:编写
~/.claude/skills/<name>/SKILL.md(frontmatter 中包含name和description,并写明应触发该技能的短语,然后添加根据会话整理出的步骤)。保存前先展示内容。告知用户输入/<name>即可使用。 - 自动化:编写脚本或计划任务,运行一次,并展示结果。
切勿删除或编辑会话文件。切勿将历史记录发送到任何地方:所有内容都保留在电脑上。
Notes
- 每周运行一两次:每份报告只读取指定天数内的记录。
- 摘要只保留用户输入的内容,不包含 Claude 的回答,因此文件较小。工具错误按会话统计,可用于了解 Claude 在哪些地方遇到困难。