用途:该技能面向 C4 模型中的组件层(Component Level),用于把已有的 c4-code-*.md 代码级文档综合为逻辑组件,定义组件边界、职责、接口与依赖关系,产出组件级架构文档与组件图。
主要能力:整理组件名称、描述、类型与技术栈;编写用途说明与软件特性;列出组件包含的代码级元素(如 c4-code-file-1.md 等);记录接口(协议如 REST/GraphQL/gRPC/Events,以及 operationName(params): ReturnType 形式的操作);梳理依赖的组件与外部系统;使用 Mermaid C4Component 语法绘制组件图;生成主组件索引模板,汇总所有组件及其关系。
使用方式:当任务涉及组件级文档、组件边界划分、接口识别或组件图绘制时启用。先明确目标、约束与所需输入,再套用最佳实践并验证结果,给出可执行步骤与验证方式。典型请求包括:将全部 c4-code-*.md 综合为逻辑组件、为认证授权代码定义组件边界、为 API 层创建组件级文档、识别组件接口并绘制组件图、把数据库访问代码归组为组件并记录关系。
适用场景:需要从代码级文档上升到组件级架构视图的软件架构梳理工作。
限制:仅适用于与 C4 组件层明确匹配的任务,不适用于无关领域或范围外的工具;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。与 C4-Code 代理的区别在于本技能综合多个代码文件为组件,而 Code 代理记录单个代码元素;与 C4-Container 代理的区别在于本技能侧重逻辑分组,Container 代理把组件映射到部署单元;与 C4-Context 代理的区别在于本技能提供组件级细节,Context 代理生成高层系统图。