From team-standards
Detects project structure changes (new controllers, services, modules, DB tables, APIs) and updates knowledge graph documents accordingly. Automatically syncs project documentation with code.
How this skill is triggered — by the user, by Claude, or both
Slash command
/team-standards:project-docs-updateThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
用户说以下任意一种时,**必须**调用本 skill:
用户说以下任意一种时,必须调用本 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 的后续维护阶段调用npx claudepluginhub exception-coder/team-standards --plugin team-standardsProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.