Menu
当检测到项目结构变更（新增 Controller/Service/模块/数据库表/API 接口）或用户要求「更新项目文档」「同步知识图谱」时触发。负责识别哪些知识图谱文档需要更新并执行更新。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | project-docs-update |
| description | 当检测到项目结构变更（新增 Controller/Service/模块/数据库表/API 接口）或用户要求「更新项目文档」「同步知识图谱」时触发。负责识别哪些知识图谱文档需要更新并执行更新。 |
用户说以下任意一种时，必须调用本 skill：
智能提醒（非强制，建议性触发）：
git-commit-standards 检测到 commit 涉及新增 Controller/Service/Mapper/Entity 时，提醒用户运行本 skilldesign-doc-required 的设计文档涉及新增模块时，提醒用户初始化模块文档用户目录知识库 {KG_ROOT}/（= {USER_DOCUMENTS}/ai-docs/{project}/）下已存在知识图谱文档（通过 init-project-docs 生成）。
若 {KG_ROOT}/00_project_overview.md 不存在，提示用户先运行 init-project-docs。
知识图谱统一存放在用户目录知识库，不再写入项目
docs/。下文{KG_ROOT}/一律指{USER_DOCUMENTS}/ai-docs/{project}/。
flowchart TD
A([收到更新指令]) --> B["读取 {KG_ROOT}/00_project_overview.md 获取当前文档状态"]
B --> C[扫描代码结构 - 与文档对比]
C --> D[生成差异报告]
D --> E{用户选择模式}
E -->|自动模式| F[自动更新所有差异文档]
E -->|确认模式| G[逐项展示差异，等待用户确认]
F --> H[输出更新摘要]
G --> H
扫描：Controller/Service 包结构（Java）或 features/ 目录（Flutter）
对比：{KG_ROOT}/02_module_map.md
触发更新条件：
扫描：Controller 层的 @RequestMapping 等注解
对比：{KG_ROOT}/05_api_map.md
触发更新条件：
扫描：Entity/Model 类、Mapper XML、建表语句
对比：{KG_ROOT}/04_data_model_map.md
触发更新条件：
扫描：综合 Controller + 前端页面/路由
对比：{KG_ROOT}/06_frontend_backend_mapping.md
触发更新条件：
扫描：项目实际的分层结构和依赖关系
对比：{KG_ROOT}/08_constraints_and_rules.md
触发更新条件：
| 文档 | 变更类型 | 具体内容 | 优先级 |
|---|---|---|---|
02_module_map.md | 新增 | 发现新模块 {name} 未记录 | 高 |
05_api_map.md | 新增 | POST /api/xxx 未记录 | 高 |
04_data_model_map.md | 变更 | {table}.{field} 类型已变更 | 中 |
扫描完成：
- 检查文档数：{N}
- 需要更新：{N} 份
- 已自动更新：{N} 份
- 需人工确认：{N} 份（业务流程/术语类文档）
| 文档 | 默认模式 | 原因 |
|---|---|---|
02_module_map.md | 自动 | 可从代码结构推断 |
04_data_model_map.md | 自动 | 可从 Entity/DDL 推断 |
05_api_map.md | 自动 | 可从 Controller 注解推断 |
06_frontend_backend_mapping.md | 自动 | 可从代码引用关系推断 |
00_project_overview.md | 确认 | 项目定位需人工判断 |
03_business_flow_map.md | 确认 | 业务流程需人工确认 |
07_glossary.md | 确认 | 术语含义需人工确认 |
08_constraints_and_rules.md | 确认 | 架构规则需人工决策 |
09_refactor_plan.md | 确认 | 重构计划需人工决策 |
10_change_log.md | 自动 | 追加格式固定 |
来源：team-standards Mermaid 规范
=、,、/、<、>、(、)、[、]、: 时必须加引号< > 改用文字classDiagram 方法名不含中文design-doc-required（本 skill 属于文档维护类，非开发类）{KG_ROOT}/ 下文件后，自动触发 doc-index-required Phase-B 更新索引init-project-docs 的后续维护阶段调用Use when writing, reviewing, or modifying source code in any language (Java / TypeScript / JavaScript / Dart / Python / Kotlin / Go / Vue / React 等). 跨语言通用编码铁律 7 条 + 注释三档,语言专属 skill (java-coding-standards / korepos-backend-service 等) 在此基础上叠加。MUST 自动触发,不需用户显式要求。
Use when writing, reviewing, or modifying any Java code. You MUST follow these mandatory rules at all times. Apply automatically without being asked. 通用条款见 coding-standards-common；本文件仅列 Java 独占规则（阿里巴巴黄山版强制项的 Java 专属部分）。
Use when the user asks to commit code or generate a commit message AND the staged diff is non-trivial (>2 files, >30 net lines, or contains new/renamed/deleted files). For trivial commits (≤2 files, ≤30 lines, only modifications to existing files) skip this skill and write a clear `git commit` message directly — `hooks/check-git-commit-skill.js` enforces the same threshold at the Bash layer (only blocks `git commit` when staged diff exceeds it). Compose the message from the current session's edit intent first; only re-read diffs to cover gaps. Automatic stage/commit/push applies ONLY to the team-standards plugin source repository, never to business projects that merely install this plugin.
Use BEFORE answering single-service backend questions about table relations / ER / SQL / state transitions / atomic capabilities or project-level technical pain points (subprocess, concurrency, perf, external deps); BEFORE Write/Edit any .md describing such content (anywhere — docs/, ai-docs/, scenarios/, work-log/). Auto-append candidates to `_candidates.md` after investigation discovers reusable facts, or when same tech concern raised ≥3 rounds in one session. Knowledge graph ownership = investigated service, not cwd. Detailed triggers (7 BLOCKING conditions) and scope boundaries listed in `## BLOCKING 强触发清单` section of SKILL.md body.
Use when writing or modifying code that integrates an LLM or builds an agent —— imports langchain4j / spring-ai / openai / anthropic 等 SDK；定义 @Tool / AiService / function-calling 工具；拼装 prompt；解析 LLM 输出。在 coding-standards-common 之上叠加的 LLM/Agent 集成编码铁律：确定性优先、LLM 输出当不可信入参、模糊→结构化用受控枚举、约定单一来源、工具描述是运行时契约、Agent 循环必须兜底、上下文由代码注入。MUST 自动触发，先满足 coding-standards-common 再走本 skill。
当用户要求「架构检查」「lint」「检测架构违规」时触发；当对 Flutter 项目的 presentation/domain/data/infrastructure 层代码执行 Edit/Write 后自动触发一次轻量检查。