AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载本文以仓库内技能文档 c4-component/SKILL.md 为主体讲解如何利用该技能将 C4 Code 级文档合成为组件级架构文档——包括组件边界划分、接口定义、依赖关系与 Mermaid 组件图。读完本文你将掌握完整的组件级文档模板、C4Component 图语法以及该技能在自底向上 C4 工作流Code → Component → Container → Context中的调用方式与输出规范。技能定位何时使用 c4-componentc4-component是 agentic-awesome-skills 仓库中 plugins/agentic-awesome-skills-claude/skills 目录下的一组 C4 文档技能之一另有 c4-code、c4-container、c4-context 与总编排技能 c4-architecture-c4-architecture。该技能在前置元数据frontmatter中声明name:c4-componentdescription: 精通 C4 Component 级文档的专家将 C4 Code 级文档合成为组件级架构定义组件边界、接口与关系risk:safesource:communitydate_added:2026-02-27适用场景Use this skill when需要处理 c4 component 级别组件名的任务或工作流需要组件级component name的指导、最佳实践或检查清单。不适用场景Do not use this skill when任务与 c4 component 级别组件名无关需要该范围之外的其他领域或工具。通用执行指令Instructions澄清目标、约束与所需输入应用相关最佳实践并验证产出提供可执行的步骤与验证方式若需要详细示例技能文档要求打开resources/implementation-playbook.md注该实现手册文件未包含在当前仓库的此技能目录中目录内仅有 SKILL.md 本体。组件文档模板从 Overview 到 Dependencies 的完整骨架该技能为每个组件规定了结构化的文档模板保证多个组件的文档格式一致、可被上层 Container 级文档直接引用。Overview概览- **Name**: [组件名] - **Description**: [组件用途的简短描述] - **Type**: [组件类型Application、Service、Library 等] - **Technology**: [使用的主要技术]Purpose目的用详细文字说明该组件做什么、解决什么问题。这是组件文档的为什么存在段落应当描述组件在系统中的角色。Software Features软件特性以列表形式列出组件提供的每一项软件特性- [特性 1]: [描述] - [特性 2]: [描述] - [特性 3]: [描述]Code Elements代码元素组件是由若干 C4 Code 级文档c4-code-*.md合成而来的因此本小节需列出并链接组件内含的代码级元素- c4-code-file-1.md - [描述] - c4-code-file-2.md - [描述]这正是该技能与 c4-code 技能的衔接点Code 级技能负责把每个代码目录细化为函数签名、类结构、依赖清单Component 级技能则把这些分散的 Code 级文档按逻辑边界聚合为一个有名字、有职责的组件。Interfaces接口组件通过接口对外暴露能力每个接口需记录协议类型、用途与操作签名### [接口名] - **Protocol**: [REST/GraphQL/gRPC/Events 等] - **Description**: [该接口提供的功能] - **Operations**: - operationName(params): ReturnType - [描述]Dependencies依赖依赖分为两类分别列出Components Used使用的组件[组件名]: [使用方式]External Systems外部系统[外部系统]: [使用方式]绘制组件图Mermaid C4Component 语法与关键原则组件图是组件级文档的核心可视化产物。该技能明确要求使用MermaidC4Component语法并强调组件图展示的是单个容器内部的组件zoom into one container关键原则Key Principles只展示单个容器内的组件放大聚焦一个容器聚焦逻辑组件及其职责展示组件接口它们对外暴露了什么展示组件之间的交互方式包含外部依赖其他容器、外部系统。语法要点说明可从上例归纳Container_Boundary定义容器边界块Component声明普通组件、ComponentDb声明数据库类组件Container_Ext/System_Ext表示容器外部或系统外部的实体Rel声明组件间或跨边界的关系第四个参数如API可标注通信方式。title语句用于给出图名。Master Component Index全系统组件总索引模板当系统中存在多个组件时该技能提供了总索引模板将全部组件集中列出并绘制全局关系图# C4 Component Level: System Overview ## System Components ### [Component 1] - **Name**: [组件名] - **Description**: [简短描述] - **Documentation**: c4-component-name-1.md ### [Component 2] - **Name**: [组件名] - **Description**: [简短描述] - **Documentation**: c4-component-name-2.md ## Component Relationships [Mermaid 图展示所有组件及其关系]这份索引是下层 c4-container 技能把组件映射到部署单元与 c4-context 技能高层系统视图的重要输入。在自底向上 C4 工作流中的位置Phase 2 组件合成本技能并非孤立存在——仓库中的总编排技能 c4-architecture-c4-architecture 实现了完整的自底向上 C4 文档化流程Code → Component → Container → Context其中Phase 2: Component-Level Synthesis正是以subagent_typec4-architecture::c4-component调用本技能执行两个任务2.1–2.2 创建组件文档收集 Phase 1 生成的全部c4-code-*.md依据以下边界准则划分逻辑组件领域边界相关的业务功能技术边界共享的框架、库组织边界若可辨识团队归属。随后为每个组件产出 Overview、Purpose、Software Features、Code Elements、Interfaces、Dependencies、Component Diagram 七大部分并保存为C4-Documentation/c4-component-component-name.md。2.3 创建 Master Component Index基于全部c4-component-*.md生成系统组件总索引C4-Documentation/c4-component.md包含组件清单与展示组件间、外部系统依赖的 Mermaid 关系图。最终文档统一组织在C4-Documentation/目录下C4-Documentation/ ├── c4-code-*.md # Code 级文档每个目录一份 ├── c4-component-*.md # Component 级文档每个组件一份 ├── c4-component.md # Master component index ├── c4-container.md # Container 级文档 ├── c4-context.md # Context 级文档 └── apis/ # API 规格 └── [container]-api.yaml # 每个容器的 OpenAPI 规格编排注意点Coordination Notes与本技能相关部分包括增量合成——每一层级都建立在前一层级文档之上完整覆盖——所有目录都必须先有 Code 级文档才能进行合成链接一致性——文档之间互相正确链接Mermaid 图——一律使用规范的 C4 Mermaid 记法。与其他层级技能的关键区别对比对象本技能c4-component对端技能c4-code将多个代码文件合成为组件逐个记录代码元素函数、类、模块c4-container聚焦逻辑分组将组件映射到部署单元c4-context提供组件级细节创建高层系统图人、系统、外部依赖输出规范Output Examples当合成组件时最终输出必须包含清晰的组件边界及划分理由rationale有描述性的组件名称与用途每个组件的完整特性列表带协议与操作的完整接口文档指向所有内含c4-code-*.md文件的链接展示关系的Mermaid 组件图包含全部组件的Master component index跨组件一致的文档格式。典型交互示例Example InteractionsSynthesize all c4-code-*.md files into logical components将所有 Code 级文档合成为逻辑组件Define component boundaries for the authentication and authorization code为认证授权代码划定组件边界Create component-level documentation for the API layer为 API 层创建组件级文档Identify component interfaces and create component diagrams识别组件接口并绘制组件图Group database access code into components and document their relationships将数据库访问代码归组为组件并记录其关系。限制与使用边界Limitations技能文档同时给出了三条明确约束使用时应严格遵守仅当任务与上述范围明确匹配时才使用本技能不可将技能产出视为环境特定验证、测试或专家评审的替代品当缺少所需输入、权限、安全边界或成功标准时应停下来请求澄清而不是臆测继续。这一点与整个 C4 技能族的定位一致文档生成是辅助最终仍需要针对真实环境的验证与专家把关。在 SKILL.md 的 frontmatter 中本技能风险等级被标记为safe与critical级别的总编排技能形成对比意味着它只负责文档合成不涉及代码变更或高风险操作。仓库根目录另有一份同源副本 skills/c4-component/SKILL.md内容一致可按需查阅。赞分享AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐C4 容器级架构文档技能实战基于 agentic-awesome-skills 的系统部署建模指南C4 容器级架构文档技能实战基于 agentic awesome skills 的系统部署建模指南 本文基于开源仓库 agentic awesome skilAI 技能AI 插件基于 C4 模型的自底向上架构文档生成工作流在 agentic-awesome-skills 中为仓库生成 Context-Container-Component-Code 四级架构文档基于 C4 模型的自底向上架构文档生成工作流在 agentic awesome skills 中为仓库生成 Context Container ComponeAI 技能AI 插件C4 Context 层架构文档化实战用 c4-context Agent 绘制系统全景视图C4 Context 层架构文档化实战用 c4 context Agent 绘制系统全景视图 导读 本文围绕 agents24 仓库中 c4 architecAI 插件AI 技能开发工具上一篇VX-API反调试技术深度解析10种绕过检测的实战方法下一篇System Informer深度解析Windows系统监控与调试的终极实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
