SuperAPI AI 工具集

c4-context

写作与研究

查看项目

更新于 10-15 22:10

技能介绍

用途:该技能面向 C4 模型中的 System Context(系统上下文)层级,用于为系统创建高层级上下文文档,说明系统边界、与之交互的人与外部系统,而不涉及技术协议等底层细节。适合需要为干系人提供易读系统全貌的任务。

主要能力:可产出系统概述(短描述与长描述)、人物角色(人类用户、程序化用户、外部系统)及其目标与所用功能、系统功能列表、按功能与角色绘制的用户旅程、外部系统与依赖(类型、集成方式、用途),以及使用 Mermaid C4Context 语法绘制的系统上下文图,并链接到容器与组件文档。

使用方式:在任务明确属于系统上下文层级时使用。先澄清目标、约束与所需输入,再套用相关最佳实践并验证结果,给出可执行步骤与校验方式。典型请求包括:为该系统中创建 C4 上下文级文档;识别全部角色并绘制关键功能的用户旅程;记录外部系统并创建系统上下文图。Mermaid 图遵循 C4 原则:以人和软件系统为中心,清晰展示系统边界,包含所有用户(含程序化)与外部系统,保持对非技术受众友好,避免展示技术、协议或低层细节。

适用场景:需要向业务或非技术干系人介绍系统全貌、梳理角色与旅程、盘点外部依赖时。

限制:仅适用于与上述范围明确匹配的任务;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。与 C4-Container、C4-Component、C4-Code 技能的分工不同,本技能只提供高层系统视图。