mcpField
R
reclaude

reclaude

github.com/brianlovinAgent 工作流3792.8k 次安装31 周前更新
代码仓库

关于 reclaude

这项技能用于重构 CLAUDE.md,让核心指引保持简洁,并将详细规则分开整理。它会检查文件长度、工作流与验证指引、矛盾内容、可复用技能候选项,以及应迁移或删除的内容。

主要功能

  1. 01评估 CLAUDE.md 长度
  2. 02将指引整理到规则文件
  3. 03补充工作流与验证指引
  4. 04找出相互冲突的指令
  5. 05发现可复用技能候选项
  6. 06标记应删除的内容

适用场景

  1. 01重构过长的 CLAUDE.md
  2. 02补充缺失的验证命令
  3. 03按主题拆分项目规则
  4. 04检查指令之间的矛盾

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/brianlovin/agent-config --skill reclaude

安装后在 Claude Code 中输入/reclaude确认已加载。

详细介绍

reclaude

重构 CLAUDE.md 文件,使其遵循渐进式披露原则。

提示词

我希望你重构我的 CLAUDE.md 文件,使其遵循渐进式披露原则。

请按以下步骤操作:

1. 检查长度

报告当前行数,并指出以下问题:

  • 理想:少于 50 行
  • 可接受:50–100 行
  • 需要重构:超过 100 行(将内容移至 .claude/rules/ 文件)
2. 整合工作流编排

阅读 ~/.claude/skills/workflow/SKILL.md 中的工作流技能,并将其原则整合到 CLAUDE.md 或 .claude/rules/workflow.md 文件中。请根据项目调整内容,不要逐字照搬,但要确保涵盖以下关键行为:

  • 对非简单任务使用计划模式
  • 子 Agent 策略
  • 使用 tasks/lessons.md 的自我改进循环
  • 将任务标记为完成前先进行验证
  • 对非简单变更进行简洁性检查
  • 自主修复 Bug

对于简短的 CLAUDE.md,添加精简的工作流章节。对于较长的文件,创建 .claude/rules/workflow.md 并链接到该文件。

3. 确保存在验证章节

检查是否有包含 Claude 可在完成变更后运行的命令的 ## Verification 章节。如果没有:

  • 在 package.json 中查找测试、lint、类型检查和构建脚本
  • 查找 Makefile、justfile 或其他任务运行器
  • 添加包含已发现命令的 ## Verification 章节

这一点至关重要——能够验证工作时,Claude 的表现会显著提升。

4. 查找矛盾

找出彼此冲突的指令。对于每处矛盾,询问我希望保留哪种说法。

5. 检查可提取为全局技能的内容

查找可整理成 ~/.claude/skills/ 中可复用全局技能的内容:

  • 与工具或框架相关(而非项目专属)
  • 相同指令在 2 个或更多项目中出现(或适用于这些项目)
  • 内容较充实(超过 20 行)

如果找到,请建议创建全局技能,并提供名称和描述。

6. 确定根目录 CLAUDE.md 中的必要内容

仅提取适合放入根目录 CLAUDE.md 的内容:

  • 一句话项目描述
  • 包管理器(如果不是 npm)
  • 不显而易见的命令(跳过 npm test、npm run build 等标准命令)
  • .claude/rules/ 文件链接及简要说明
  • 验证章节(始终必需)
7. 整理其余内容

按类别将其余指令整理到 .claude/rules/ 文件中(例如:TypeScript 规范、测试模式、API 设计、Git 工作流)。

8. 标记应删除的内容

找出应彻底删除的内容:

  • API 文档——改为链接到外部文档
  • 代码示例——Claude 可以通过阅读源文件推断
  • 接口/类型定义——这些已存在于代码中
  • 泛泛而谈的建议——“编写整洁的代码”“遵循最佳实践”
  • 显而易见的指令——“对 .ts 文件使用 TypeScript”
  • 冗余信息——Claude 已知的内容
  • 过于模糊的内容——无法据此采取行动的指令

目标模板

# Project Name

One-line description.

## Commands
- `command` - what it does (only non-obvious ones)

## Rules
- [Topic](/.claude/rules/topic.md) — brief description

## Verification
After making changes:
- `npm test` - Run tests
- `npm run lint` - Check linting

保留与删除的内容

在 CLAUDE.md 中保留:

  • Claude 无法从 package.json 推断出的命令
  • 本项目特有的非标准模式
  • 项目中的注意事项和易踩的坑
  • 详细规则文件的链接

移至 .claude/rules/:

  • 详细规范(单个主题超过 10 行)
  • 风格指南
  • 架构决策
  • 工作流文档

彻底删除:

  • Claude 可以通过阅读代码库推断出的内容
  • 该语言/框架的标准实践
  • 已在其他位置提供的文档(改为链接)

评论

支持 Markdown