claude-md
按最佳实践创建或更新 CLAUDE.md，帮助 AI agent 更快理解项目。Use when users want to create, update, audit, or improve a CLAUDE.md file.
Best for New project setupWorks with GitHubLow risk
⌘source
- author
@lhfer- language
- Python
★1.1kstars
195forks
May 5, 2026
✦overview.md
Key Features
- ·Create CLAUDE.md from scratch
- ·Update existing CLAUDE.md with best practices
- ·Audit CLAUDE.md for quality and anti-patterns
- ·Keep content concise under 300 lines
- ·Focus on long-term project context
Use Cases
- →Starting a new project and want to set up AI context early
- →Improving an existing CLAUDE.md that's outdated or bloated
- →Reviewing a CLAUDE.md for common mistakes before committing
Best for
- ✓New project setup
- ✓CLAUDE.md maintenance
- ✓CI-integrated project documentation
Not ideal for
- !One-off scripts
- !Projects without AI tool usage
FAQs
name
claude-md
description
按最佳实践创建或更新 CLAUDE.md，帮助 AI agent 更快理解项目。Use when users want to create, update, audit, or improve a CLAUDE.md file.
CLAUDE.md / 项目记忆整理
用户输入
$ARGUMENTS
支持的意图：
createupdateaudit- 指定某个路径下的
CLAUDE.md
核心原则
CLAUDE.md是 Claude Code 自动加载的长期项目上下文- 内容要短、准、长期有效
- 不要把 lint / format 规则硬塞进去
- 不要把一次性任务说明塞进去
- 不要自动生成一堆无价值内容
推荐结构
- Project Overview
- Tech Stack
- Project Structure
- Development Commands
- Critical Conventions
- Known Issues / Gotchas
执行流程
create（创建）
- 分析项目结构和技术栈
- 草拟
CLAUDE.md - 给用户审阅
- 确认后写入
update（更新）
- 读取现有
CLAUDE.md - 找出冗余、过时或不该存在的内容
- 给出优化建议
- 审阅后更新
audit（审计）
- 检查行数和结构
- 识别 anti-patterns
- 输出报告，不直接改文件
质量约束
- 目标尽量少于 300 行
- 面向所有会话都适用
- 尽量用文件引用替代长代码块
- 命令必须真实可用
$install
1-click copynpx skills add lhfer/claude-howto-zh-cn --skill claude-mdSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.