Claude代码开发辅助工具

MDD(Manual-Driven Development)是一个将Claude Code转化为结构化开发伙伴的工具,提供21种模式覆盖构建、审计、规划等,通过文档驱动开发和钩子强制执行规则。

  • by TheDecipherist
  • Shell
  • 本地部署
  • 558 星标
  • 更新于
在 GitHub 查看 TheDecipherist/claude-code-mastery

使用说明

✨ MDD——手动驱动开发:独立包

MDD将Claude Code变成了一个结构化的开发合作伙伴:每个功能都始于文档,每个修复都始于审计。 21种模式 涵盖构建、审计、规划、运维运行手册等,全部通过 /mdd 在任何Claude Code会话中。

安装: npm install -g @thedecipherist/mdd && mdd install

GitHub→ · npm →

🚀 新的2-14-2026: Claude代码掌握入门套件

从V1到V5的所有内容都已整合到生产就绪的项目模板中。16个斜线命令、确定性钩子强制、经过实战考验的MongoDB包装器、实时AI监控和三层安全性——所有这些都已连接好并准备好克隆。 停止配置,开始构建。

Claude Code Mastery V2(已过时)

最大化克劳德代码的完整指南:全局Claude.md、MCP服务器、命令、钩子、技能以及为什么单目的聊天很重要。

这个版本现在已经过时了。请改用新的Claude Code Mastery入门套件

以前的版本:

版本5

V4

第3版


太长,读不下去了 您的全球 ~/.claude/CLAUDE.md 是一个安全看门人和项目脚手架蓝图。MCP服务器扩展了Claude的功能。自定义命令使工作流自动化。 钩子确定性地执行规则 (CLAUDE.md可能会失败)。技能包可重用的专业知识。研究表明,在一次聊天中混合话题会导致 性能下降39%.


📚 目录


🚀 快速开始

# Clone this repo
git clone https://github.com/TheDecipherist/claude-code-mastery.git
cd claude-code-mastery

# Copy hooks to your Claude config
mkdir -p ~/.claude/hooks
cp hooks/* ~/.claude/hooks/
chmod +x ~/.claude/hooks/*.sh

# Copy the settings template (review and customize first!)
cp templates/settings.json ~/.claude/settings.json

# Copy skills
mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

📖 指南

📱 在GitHub页面上阅读V3 | 📄 查看GUIDE.md(V3)

覆盖范围

部分 主题 关键要点
1 全局CLAUDE.md作为安全守护者 定义一次,处处继承
2 项目脚手架规则 每个项目都遵循相同的结构
3 MCP服务器 外部工具集成
4 Context7 实时文档访问
5 自定义命令 工作流自动化
6 单一目的聊天 39%的内容因主题混合而退化
7 技能和钩子 对建议的执行

📁 存储库内容

claude-code-mastery/
├── GUIDE.md                    # The complete guide
├── templates/
│   ├── global-claude.md        # ~/.claude/CLAUDE.md template
│   ├── project-claude.md       # ./CLAUDE.md starter
│   ├── settings.json           # Hook configuration template
│   └── .gitignore              # Recommended .gitignore
├── hooks/
│   ├── block-secrets.py        # PreToolUse: Block .env access
│   ├── block-dangerous-commands.sh  # PreToolUse: Block rm -rf, etc.
│   ├── end-of-turn.sh          # Stop: Quality gates
│   ├── after-edit.sh           # PostToolUse: Run formatters
│   └── notify.sh               # Notification: Desktop alerts
├── skills/
│   ├── commit-messages/        # Generate conventional commits
│   │   └── SKILL.md
│   └── security-audit/         # Security vulnerability checks
│       └── SKILL.md
└── commands/
    ├── new-project.md          # /new-project scaffold
    ├── security-check.md       # /security-check audit
    └── pre-commit.md           # /pre-commit quality gates

🔧 安装

先决条件

  • 克劳德代码 安装
  • Python 3.8+(用于Python钩子)
  • jq (用于shell钩子中的JSON解析)

步进

1.安装挂钩

# Create hooks directory
mkdir -p ~/.claude/hooks

# Copy hook scripts
cp hooks/block-secrets.py ~/.claude/hooks/
cp hooks/block-dangerous-commands.sh ~/.claude/hooks/
cp hooks/end-of-turn.sh ~/.claude/hooks/

# Make shell scripts executable
chmod +x ~/.claude/hooks/*.sh

2.配置设置

# If you don't have settings.json yet
cp templates/settings.json ~/.claude/settings.json

# If you already have settings.json, merge the hooks section manually

3.安装技能

# Create skills directory
mkdir -p ~/.claude/skills

# Copy skills
cp -r skills/* ~/.claude/skills/

4.建立全球CLAUDE.md

# Copy template
cp templates/global-claude.md ~/.claude/CLAUDE.md

# Customize with your details
$EDITOR ~/.claude/CLAUDE.md

5.验证安装

# Start Claude Code
claude

# Check hooks are loaded
/hooks

# Check skills are loaded
/skills

🔒 为什么钩子很重要

CLAUDE.md规则是 建议.钩子是 执行.

CLAUDE.md saying "don't edit .env"
  → Parsed by LLM
  → Weighed against other context
  → Maybe followed

PreToolUse hook blocking .env edits
  → Always runs
  → Returns exit code 2
  → Operation blocked. Period.

社区成员的真实例子:

“我的PreToolUse钩子每周会阻止Claude访问机密(.env文件)几次。Claude并没有非常严格地遵守Claude.md规则。”

挂钩退出代码

代码 含义
0 成功,允许操作
1 错误(仅向用户显示)
2 阻止操作,将stderr馈送给Claude

🧠 为什么是单一目的聊天

研究一致表明,主题混合会破坏准确性:

研究 发现
多回合对话 性能下降39% 混合主题时
上下文腐烂 回忆随着上下文的增长而减少
环境污染 2%早期错位→ 40% 故障率

黄金法则:一个任务,一个聊天


🤝 贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 添加你的钩子、技能或改进
  4. 提交带有描述的PR

贡献的想法

  • []更多特定于语言的钩子(Go、Rust、Ruby)
  • []其他技能(代码审查、文档、测试)
  • []框架特定脚手架模板
  • []MCP服务器配置示例

📚 来源

官方文件

研究

社区


📄 许可证

MIT许可证-请参阅 许可证


建于❤️ 通过 解密者 Claude Code社区