Stats
Actions
Tags
From team-standards
Enforces mandatory Markdown writing standards for Mermaid diagrams, complex tables, and structured documentation. Validates Mermaid syntax (emoji, special chars, mindmap, sequenceDiagram, subgraph, node IDs) and triggers TOC review on structural edits.
How this skill is triggered — by the user, by Claude, or both
Slash command
/team-standards:markdown-writing-standardsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
以下规则覆盖 Markdown 文档中的 Mermaid 图表、表格、代码块等结构化内容的编写规范。**生成任何包含 Mermaid 的 Markdown 内容时必须遵守，不得以任何理由绕过。**
以下规则覆盖 Markdown 文档中的 Mermaid 图表、表格、代码块等结构化内容的编写规范。生成任何包含 Mermaid 的 Markdown 内容时必须遵守，不得以任何理由绕过。
在生成或修改任何 Mermaid 代码块之前，必须先完成本规范的检查。每个 Mermaid 代码块在写入文件前必须通过「第 1 节致命错误清单」的逐项排查。以下错误会导致 Mermaid 渲染器直接报错或产生乱图，生成每个 Mermaid 代码块后必须逐项检查：
Mermaid 解析器不支持 Unicode Emoji 字符，包括但不限于：
| 禁止字符 | 替代写法 |
|---|---|
| 🆕 ✅ ❌ 🔧 ♻️ | [新建] [已完成] [失败] [改造] [复用] |
| 1️⃣ 2️⃣ 3️⃣ | 1. 2. 3. |
| ⚠️ 🚀 📦 | [警告] [启动] [包] |
错误: A["🆕 新建模块"]
正确: A["新建模块"]
正确: A["模块A [新建]"]
节点文本中包含以下字符时，整个文本必须用双引号包裹：
（）、中文逗号 ，、中文分号 ；()（与节点形状语法冲突）:（与某些图类型关键字冲突）/、等号 =错误: A{Planning: 需要规划？}
正确: A{"Planning: 需要规划?"}
错误: B[格式化输出（SSE/同步）]
正确: B["格式化输出 SSE/同步"]
<br/> 适用范围| 图类型 | <br/> 支持 | 替代方案 |
|---|---|---|
| graph / flowchart 节点文本 | 支持 | - |
| sequenceDiagram 参与者/消息 | 不支持 | 用 \n 或缩短文本 |
| mindmap 节点 | 不支持 | 拆成子节点 |
| stateDiagram 状态名 | 不支持 | 用短名称 |
| subgraph 标题 | 支持 | - |
连线标签 -->|text| | 不支持 | 用短文本 |
mindmap 是 Mermaid 中语法最严格的图类型：
规则1: 缩进必须用空格，且同级节点缩进量一致（推荐 2 或 4 空格）
规则2: 节点文本中不能有冒号、括号等特殊字符
规则3: 节点文本不支持 <br/> 换行
规则4: 根节点用 root((文本)) 或 root(文本)
规则5: 如果节点文本包含特殊字符，需要移除或替换为普通文字
错误:
mindmap
root((系统架构))
模块A: 用户管理
模块B（订单）
正确:
mindmap
root((系统架构))
模块A 用户管理
模块B 订单
规则: subgraph 的显示名必须用双引号包裹，ID 用英文无空格
错误: subgraph 领域层 llm-domain
正确: subgraph Domain["领域层 llm-domain"]
规则: 连线标签中包含特殊字符时，必须用双引号包裹
错误: A -->|达到 maxIterations 或 timeout| B
正确: A -->|"达到maxIterations或timeout"| B
规则1: 参与者名中不能包含 <br/> ，用短名 + alias 代替
规则2: 消息文本中的特殊字符需要注意转义
规则3: alt/opt/loop 块的描述文本保持简短
规则4: 尖括号 < > 在消息文本中需要用 HTML 实体或避免使用
错误:
participant C as Controller<br/>(Agent/Secretary)
正确:
participant C as Controller
Note over C: Agent/Secretary
规则: 节点 ID 只能包含字母、数字、下划线，不能以数字开头
错误: 1-input["Input"]
正确: INPUT["Input"]
正确: step1_input["Input"]
详细语法速查见辅助文件
mermaid-syntax-ref.md
flowchart TD
A(["开始"]) --> B["处理步骤"]
B --> C{"判断条件?"}
C -->|"条件1"| D["分支1"]
C -->|"条件2"| E["分支2"]
D --> F(["结束"])
E --> F
graph TD
subgraph GroupA["分组A"]
A["模块1"] --> B["模块2"]
end
subgraph GroupB["分组B"]
C["模块3"]
end
B --> C
style C stroke-dasharray: 5 5
sequenceDiagram
participant A as ServiceA
participant B as ServiceB
A->>B: request
alt 成功
B-->>A: 200 OK
else 失败
B-->>A: 500 Error
end
mindmap
root((主题))
分类A
子项1
子项2
分类B
子项3
stateDiagram-v2
[*] --> Idle
Idle --> Running: start
Running --> Done: complete
Running --> Failed: error
Done --> [*]
Failed --> [*]
classDiagram
class Animal {
+String name
+eat() void
}
class Dog {
+bark() void
}
Animal <|-- Dog
每个 Mermaid 代码块写入文件前，必须逐项确认：
ID["显示名"] 格式<br/> 仅用在 flowchart/graph 节点文本中<br/>| 场景 | 推荐格式 |
|---|---|
| 多维度对比（每项有 2+ 属性） | 表格 |
| 简单枚举（每项只有名称和描述） | 列表 |
| 配置项说明（字段/类型/默认值/说明） | 表格 |
| 步骤流程（有先后顺序） | 有序列表 |
|---|---|）|:---|、居中 |:---:|、右对齐 |---:|```java、```sql、```mermaid```text，不要用无标注的 ``````yaml、```json、```propertiesSELECT、FROM、WHERE# 仅用于文档标题，全文只出现一次## 用于一级章节编号：## 1. 基本信息### 用于二级章节：### 1.1 子章节#### 用于三级章节（尽量避免超过 4 级）##）之间用 --- 分隔线###）之间用空行分隔，不加分隔线以下任一情况触发一次目录复核：
## / ### 章节轻微修改（段落文字调整、错别字、补充代码示例、列表项增减）无需触发。
第一步：列出当前目录快照
用 Grep 列出所有 ^## 与 ^### 行，形成当前 TOC 快照，肉眼扫一遍整体结构。
第二步：对照下表逐项排查
| 检查项 | 问题信号 | 处理方式 |
|---|---|---|
| 分类混杂 | 平坦章节列表里混入不同性质的内容（如搭建 / 日常开发 / 报错排查 / 附录 都挤在同级 ## 下） | 拆成 Part I/II/III 或按场景分组，顶部加读者分流导航 |
| 内容重复 | 两个章节内容高度重叠或标题语义相近 | 合并，只保留一份，另一份用锚点链接指向 |
| 标题重复 | 同一文件多个章节用完全相同的标题（多个"配置"/"说明"/"示例"/"错误现象"） | 加唯一前缀（"X 的配置"/"Y 的配置"），或按父子关系下沉到更深层级 |
| 层级断层 | 出现 ## 直接跳到 ####，中间缺 ### | 补全中间层级，或把深层标题降级为粗体段落 |
| 编号错乱 | 手动编号的章节顺序/数字对不上（如"1. xxx / 3. yyy"） | 重新编号，或统一改为无编号 |
| 命名风格不统一 | 兄弟章节有的带编号、有的不带；有的描述性、有的纯名词 | 统一为一种风格 |
| 单章节超长 | 某个 ## 的内容超过全文 40%，读者难以定位子部分 | 拆成多个平级章节，或下沉到子文档并在原处留链接 |
| 交叉引用失效 | 正文提到"见第 N 节" / "详见 Y" / markdown 锚点链接，但编号已变或锚点已失效 | 全文扫描所有"第 X 节 / Section Y / 详见 Z / #anchor"，同步更新 |
| 超过 4 级嵌套 | 出现 ##### 及以上 | 降级为列表项或粗体段落，或把父章节拆出平级章节 |
第三步：判断是否需要顶部「快速导航」
出现以下信号之一时，顶部加一个快速导航块，让不同身份的读者直接跳转：
## 章节数 ≥ 8导航块示例：
## 快速导航
- **新人入职 / 首次搭建** → [Part I. 环境搭建](#part-i-环境搭建)
- **日常开发** → [Part II. 开发流程](#part-ii-开发流程)
- **报错排查** → [Part III. 报错速查](#part-iii-报错速查)
文件写入前必须逐项确认：
## → #### 之间必有 ###）[文本](#anchor)）的 anchor 与当前标题匹配| Skill | 协作方式 |
|---|---|
design-doc-required | 设计文档中的 Mermaid 图表必须遵守本规范；设计文档要求哪些图是必须的由 design-doc-required 决定，图怎么写由本规范决定 |
bug-doc-required | Bug 文档中的调用链 Mermaid 图遵守本规范 |
init-project-docs | 项目文档中的架构图遵守本规范 |
职责分工：
以下想法出现时立即停止，回到自检清单：
| 想法 | 正确处理 |
|---|---|
| "加个 Emoji 更直观" | Mermaid 不支持 Emoji，用文本标记替代 |
| "这个图很简单，不用检查" | 越简单越容易忽略引号包裹 |
| "mindmap 里加个冒号分隔" | mindmap 不支持冒号，用空格或拆子节点 |
"用 <br/> 换行更好看" | 先确认图类型是否支持 |
| "节点名用中文更清楚" | 中文节点名可以，但 ID 必须用英文 |
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.