C4 组件层

要解决什么问题

系统已经拆到容器之后，工程师仍常面对「这一容器里到底有哪些逻辑块、谁调谁、对外暴露什么」的空白。把仓库里散落的 c4-code-*.md 当作事实来源时，缺少统一的组件边界、接口清单和单容器内的关系图，评审和 onboarding 只能反复翻代码。

技能如何工作

本技能面向 C4 模型的组件层：在单个容器内把多个代码级元素综合为逻辑组件，而不是替你做部署映射（容器层）或画全系统上下文（上下文层）。

典型流程可以概括为：

• 对齐输入：明确组件名、目标、约束与已有 c4-code-*.md 等材料。
• 划定边界：给出有理由的组件划分，并为每个组件写名称、用途、类型与技术栈。
• 写清契约：为每个接口记录协议（REST / GraphQL / gRPC / Events 等）、描述与 operationName(params): ReturnType 形式的操作说明。
• 梳理依赖：区分「使用的组件」与「外部系统」，说明如何被调用或集成。
• 出图与索引：用符合 Mermaid C4Component 语法的组件图展示接口与交互，并维护主组件索引；更细的示例见 resources/implementation-playbook.md。

与相关角色的分工：C4-Code 只记录单个代码元素；本技能做文件到组件的综合；C4-Container 把组件映射到部署单元；C4-Context 负责更高层的系统图。

适用边界

任务与指定组件名的 C4 组件层无关时不必启用。输出侧应保持一致：每个组件有特性列表、完整接口文档、到相关 c4-code-*.md 的链接，以及展示关系的组件图。