中文社群最完整的 Claude Code 進階指南 — 涵蓋 CLAUDE.md 架構設計、Skills 撰寫、Subagent 編排，附可直接使用的實戰範例。
概览
——涵盖 CLAUDE.md 架构、技能创作、子代理编排，并附有实用实用示例。 维护者。一名专注于网页开发、网页爬虫自动化和API集成的自由工程师。本仓库是我实际使用Claude代码在客户项目中经验的精炼。网站 ·讨论帖 ·联系方式 三本指南相互交叉引用。推荐阅读顺序：CLAUDE.md → 技能→ Subagent。 以下技能改编自mattpocock/skills，重新制作模板提取至模板/，参考资料移至参考/，并添加了“陷阱”部分。
概述（AI 翻译）
英文 |繁體中文
中文社区中最全面的高级Claude代码指南——涵盖 CLAUDE.md 架构、技能编写、子代理编排，并附有实用实用示例。
由dianyike / 典億創研工作室维护。一名自由工程师，专注于网页开发、网页爬虫自动化和API集成。本仓库是我实际在客户项目中使用Claude代码经验的精华。
网站 ·讨论帖 ·联系方式
这是给谁的
| 你是… | 从这里开始 | 你会得到什么 |
|---|---|---|
| Claude 代码新手CLAUDE.md 指南 | 理解三层架构、钩子，以及如何避免常见的反模式 | |
| 经验丰富，希望提升自己技能指南→子代理指南 | 枢纽辐射架构、决策矩阵、黑匣子问题解决方案 | |
| 自由职业者/独立开发者实用示例：grill-me → write-prd → prd-to-plan → tdd | 从设计询问到TDD实现的完整工作流程 |
目录
| 文件 | 描述 | 观众 |
|---|---|---|
| claude-md-best-practices.md | 克洛德。 |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Claude Code Insights
English | 繁體中文
The most comprehensive advanced Claude Code guide in the Chinese-speaking community — covering CLAUDE.md architecture, Skills authoring, Subagent orchestration, with ready-to-use practical examples.
Maintained by dianyike / 典億創研工作室. Freelance engineer specializing in web development, web scraping automation, and API integration. This repo is a distillation of my real-world experience using Claude Code in client projects.
Who Is This For
| You are… | Start here | What you’ll get |
|---|---|---|
| New to Claude Code | CLAUDE.md Guide | Understand the three-layer architecture, Hooks, and how to avoid common anti-patterns |
| Experienced, looking to level up | Skills Guide → Subagent Guide | Hub-and-Spoke architecture, decision matrices, black-box problem solutions |
| Freelancer / Solo developer | Practical Examples: grill-me → write-prd → prd-to-plan → tdd | A complete workflow from design interrogation to TDD implementation |
Contents
| File | Description | Audience |
|---|---|---|
| claude-md-best-practices.md | CLAUDE.md Best Practices — why not to use /init, the three-layer architecture model, Hooks over directives, anti-patterns |
Beginners |
| skills-best-practices.md | Skills Best Practices — file format, loading mechanics, content writing principles, advanced patterns, design templates | Advanced |
| subagent-best-practices.md | Subagent Best Practices — the black-box problem and solutions, result persistence, tool scoping strategies, architectural patterns | Advanced |
The three guides cross-reference each other. Recommended reading order: CLAUDE.md → Skills → Subagent.
Practical Examples
Subagent Examples
| Example | Description | Difficulty |
|---|---|---|
| examples/security-reviewer | Dual-verification security audit — read-only /security:review (Semgrep + Codex cross-validation, confidence scoring) + opt-in /security:fix (convergence-hardened Fix-Verify Loop with falsifiable predictions, tiered rollback, hypothesis ledger). Strict review/fix boundary: review is always read-only; fix requires explicit user opt-in and runs in main conversation. Implements Harness Engineering methodology |
Advanced |
Hook Examples
| Example | Description | Difficulty |
|---|
推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add dianyike/claude-code-insights