| name | claude-context |
| description | 为任意代码模块生成或更新 CLAUDE.md 上下文文件，让 AI 在开发时自动获取业务知识，无需每次重复解释背景。
Use when:
- 用户请求为模块生成 CLAUDE.md，如"帮我生成上下文"、"建立这个模块的文档"
- 用户请求更新已有 CLAUDE.md，如"更新文档"、"同步文档"、"我改了表结构"
- 用户开始开发一个没有 CLAUDE.md 的模块
- 代码变更涉及数据库表结构、HTTP 接口、业务规则或外部依赖
- 用户运行 /gen-claude 或 /update-claude 命令
|
| argument-hint | <module-path> [update-reason] |
Claude Context — 模块知识文档生成与维护
工作模式判断
收到请求后，先判断工作模式：
- Generate 模式：目标目录不存在 CLAUDE.md，或用户明确要求重新生成
- Update 模式：目标目录已有 CLAUDE.md，且用户提供了变更原因
Generate 模式
Step 1：确定模板来源
按优先级查找：
- 项目根目录是否有
docs/CLAUDE.md设计规范.md → 提取其中的「标准模板」章节使用
- 无则使用内置默认模板（见 template.md）
Step 2：扫描目标目录
读取以下文件（存在则读，不存在跳过）：
| 文件模式 | 提取内容 |
|---|
*_mdl.go / *_model.go | 数据表结构（TableName、字段名、字段类型、注释） |
front.go / router.go / handler.go | HTTP API 端点、路由路径、认证方式 |
admin.go | 管理后台 API 端点 |
service/ 或 services/ 目录 | 核心业务逻辑、方法签名 |
provider.go | Wire 依赖关系 |
根目录 *.go 文件 | 业务说明、入口逻辑 |
Go 项目补充规则：
TableName() 方法的返回值 = 表名- 带
gorm:"column:xxx" tag 的字段 = 关键字段（忽略 id/created_at/updated_at）
gin.RouterGroup 的 .GET/.POST 调用 = API 端点- import 中的
internal/secondpart/ 路径 = 外部服务依赖
Step 3：填写模板并写入文件
- 无法从代码推断的内容写
暂无，不删除章节
Code Review 关键点 章节基于代码推断，不确定的写 待补充- 文件头时间戳填写今天日期，格式：
> 最后更新：YYYY-MM-DD | 状态：✅ 有效
- 写入路径：
<module-path>/CLAUDE.md
生成完成后输出：
✅ 已生成 <module-path>/CLAUDE.md
⚠️ 请人工检查「Code Review 关键点」章节并补充业务约束
Update 模式
Step 1：读取现有文件
读取 <module-path>/CLAUDE.md 完整内容，记录各章节现有内容。
Step 2：按变更原因有针对性地读代码
| 变更原因关键词 | 需要重新读取的文件 |
|---|
| 表结构、字段、新增表 | 对应 *_mdl.go 文件 |
| 接口、路由、API | front.go / router.go / admin.go |
| 业务规则、流程 | service/ 目录相关文件 |
| 外部依赖 | provider.go 及相关调用处 |
Step 3：只更新相关章节
严格遵守以下规则：
- ✅ 更新与变更直接相关的章节
- ✅ 更新文件头时间戳为今天
- ❌ 不修改其他章节的内容
- ❌ 不覆盖「常见错误模式」中人工积累的内容（即使为空也保留结构）
- ❌ 不删除任何章节
更新完成后输出变更摘要：
✅ 已更新 <module-path>/CLAUDE.md
📝 变更章节：[列出更新了哪些章节]
🔒 保留章节：[列出未修改的章节]
适用范围
- 主要面向 Go 项目，兼容其他语言（无法识别特定文件时，扫描所有
.go / .py / .java 等源文件）
- 适用于任何按模块组织的代码库（
internal/app/xxx、src/modules/xxx 等）
- 跨项目通用：优先读取项目自己的
docs/CLAUDE.md设计规范.md，无则用默认模板
参考文档
