用途:c4-code 是 C4 代码级(Code Level)文档专家技能,用于分析指定代码目录,产出结构化的代码级文档,覆盖函数签名、类与模块、依赖关系等。适用于需要为复杂组件补充代码级说明的场景,例如分析 src/api 目录、记录服务层类层次与依赖、为 ETL 转换器绘制数据流图等。
主要能力:按模板输出概览(名称、描述、位置、语言、用途)、代码元素(函数/方法签名、位置、依赖;类/模块的描述、位置、方法、依赖)、内部与外部依赖、关系图。对复杂结构可选用 Mermaid 图:面向对象代码用 classDiagram 展示类、接口与继承;函数式/过程式代码可用 classDiagram 加 <<module>> 展示模块结构,或用 flowchart 展示数据流与函数依赖。
使用方式:在任务明确属于该技能范围时调用,先澄清目标、约束与所需输入,再应用最佳实践并验证结果,给出可执行步骤与验证方式。示例请求包括“分析 src/api 目录并创建 C4 代码级文档”“记录认证模块所有函数的签名与数据流”等。
适用场景:OOP、函数式、过程式及混合范式的代码库文档化,如 TypeScript、Go、Rust、Elixir 等。
限制:仅用于与 C4 代码级文档明确匹配的任务;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。C4 代码图通常仅在组件复杂时创建,多数团队认为系统上下文图与容器图已足够。与 C4-Component、C4-Container、C4-Context 技能的分工不同,本技能聚焦单个代码元素与代码结构细节。具体安装命令、收费与平台信息暂未提供。