# C4 Component

> C4 组件级文档专家。将 C4 代码级文档综合为组件级架构，定义组件边界、接口和关系。当用户要求'创建组件级文档'、'定义组件边界'、'综合代码文件为组件'或'绘制组件图'时使用。

- Skill: `kscz0000/c4-component` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/c4-component`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/c4-component/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/c4-component

---


# C4 组件级：[组件名称]

## 使用此技能的场景

- 处理 C4 组件级：[组件名称] 相关的任务或工作流
- 需要 C4 组件级：[组件名称] 的指导、最佳实践或检查清单

## 不使用此技能的场景

- 任务与 C4 组件级：[组件名称] 无关
- 需要此范围之外的其他领域或工具

## 指令

- 明确目标、约束和所需输入。
- 应用相关最佳实践并验证结果。
- 提供可操作的步骤和验证方法。
- 如需详细示例，请打开 `resources/implementation-playbook.md`。

## 概览

- **名称**：[组件名称]
- **描述**：[组件用途简述]
- **类型**：[组件类型：Application、Service、Library 等]
- **技术**：[使用的主要技术]

## 目的

[详细描述此组件的功能及所解决的问题]

## 软件特性

- [特性 1]：[描述]
- [特性 2]：[描述]
- [特性 3]：[描述]

## 代码元素

此组件包含以下代码级元素：

- c4-code-file-1.md - [描述]
- c4-code-file-2.md - [描述]

## 接口

### [接口名称]

- **协议**：[REST/GraphQL/gRPC/Events/等]
- **描述**：[此接口提供的功能]
- **操作**：
  - `operationName(params): ReturnType` - [描述]

## 依赖

### 使用的组件

- [组件名称]：[使用方式]

### 外部系统

- [外部系统]：[使用方式]

## 组件图

使用正确的 Mermaid C4Component 语法。组件图展示**单个容器内**的组件：

```mermaid
C4Component
    title Component Diagram for [Container Name]

    Container_Boundary(container, "Container Name") {
        Component(component1, "Component 1", "Type", "Description")
        Component(component2, "Component 2", "Type", "Description")
        ComponentDb(component3, "Component 3", "Database", "Description")
    }
    Container_Ext(externalContainer, "External Container", "Description")
    System_Ext(externalSystem, "External System", "Description")

    Rel(component1, component2, "Uses")
    Rel(component2, component3, "Reads from and writes to")
    Rel(component1, externalContainer, "Uses", "API")
    Rel(component2, externalSystem, "Uses", "API")
```
````

**关键原则**（来自 [c4model.com](https://c4model.com/diagrams/component)）：

- 展示**单个容器内**的组件（放大到某个容器）
- 聚焦于**逻辑组件**及其职责
- 展示**组件接口**（它们暴露的内容）
- 展示组件之间如何**交互**
- 包含**外部依赖**（其他容器、外部系统）

````

## 主组件索引模板

```markdown
# C4 组件级：系统概览

## 系统组件

### [组件 1]
- **名称**：[组件名称]
- **描述**：[简短描述]
- **文档**：c4-component-name-1.md

### [组件 2]
- **名称**：[组件名称]
- **描述**：[简短描述]
- **文档**：c4-component-name-2.md

## 组件关系
[展示所有组件及其关系的 Mermaid 图]
````

## 示例交互

- "将所有 c4-code-*.md 文件综合为逻辑组件"
- "为认证和授权代码定义组件边界"
- "为 API 层创建组件级文档"
- "识别组件接口并创建组件图"
- "将数据库访问代码分组为组件并记录它们的关系"

## 关键区别

- **vs C4-Code 智能体**：将多个代码文件综合为组件；Code 智能体记录单个代码元素
- **vs C4-Container 智能体**：聚焦于逻辑分组；Container 智能体将组件映射到部署单元
- **vs C4-Context 智能体**：提供组件级细节；Context 智能体创建高层系统图

## 输出示例

综合组件时，应提供：

- 带有理由的清晰组件边界
- 描述性的组件名称和用途
- 每个组件的完整特性列表
- 包含协议和操作的完整接口文档
- 指向所有包含的 c4-code-*.md 文件的链接
- 展示关系的 Mermaid 组件图
- 包含所有组件的主组件索引
- 跨所有组件的一致文档格式

## 局限性
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代。
- 如果缺少所需输入、权限、安全边界或成功标准，请停下来请求澄清。