القائمة
分析代码库结构并生成中文 token-lean 架构文档。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
更新本项目的上游 submodule，并基于真实 git 变更分析生成文档报告。用于用户要求同步 `upstream/` 下仓库、检查上游最近更新、梳理新增内容、在 `docs/` 写更新说明，或筛选哪些更新值得优先吸收和推荐时。
| name | dev-update-codemaps |
| description | 分析代码库结构并生成中文 token-lean 架构文档。 |
分析代码库结构并生成中文 token-lean 架构文档。
在 docs/CODEMAPS/（或 .reports/codemaps/）中创建或更新 codemaps：
语言硬性要求：所有 codemap 正文、标题、表格说明、报告内容必须使用中文。 仅保留代码标识、文件路径、类名、函数名、HTTP method、依赖包名、配置 key 等技术专有名词的原文。
| 文件 | 内容 |
|---|---|
architecture.md | 高层系统图、服务边界、数据流 |
backend.md | API routes、middleware chain、service → repository 映射 |
frontend.md | 页面树、组件层级、状态管理流 |
data.md | 数据库表、关系、迁移历史 |
dependencies.md | 外部服务、第三方集成、共享库 |
每个 codemap 应为中文且 token-lean —— 针对 AI 上下文消费进行优化：
# 后端架构
## 路由
POST /api/users → UserController.create → UserService.create → UserRepo.insert
GET /api/users/:id → UserController.get → UserService.findById → UserRepo.findById
## 关键文件
src/services/user.ts (业务逻辑, 120 行)
src/repos/user.ts (数据库访问, 80 行)
## 依赖
- PostgreSQL (主数据存储)
- Redis (会话缓存、限流)
- Stripe (支付处理)
为每个 codemap 添加新鲜度标头：
<!-- 生成时间: 2026-02-11 | 扫描文件: 142 | Token 估算: ~800 -->
将摘要写入 .reports/codemap-diff.txt：
报告同样必须使用中文；技术标识可保留原文。