arc42-section-01 是 msiccdev/arc42-toolkit 中面向 arc42 架构文档第 1 节「引言与目标」的交互式引导技能。其核心用途是帮助架构师或团队按 arc42 规范撰写架构文档的入口章节,回答「系统为何存在」「什么最重要」「谁关心」三个问题。
主要能力体现在三步流程中。第一步是提问澄清:在生成任何文档之前,先询问系统名称与用途、业务问题、5–10 项核心功能、3–5 个质量目标、关键干系人及其期望、已有需求文档,以及所选详细程度(LEAN、ESSENTIAL、THOROUGH)。对于质量目标,要求使用 Q42 属性标签(可靠、灵活、高效、可用、安全、安保、适用、可运维)并给出包含具体数字的可度量场景,例如响应时间、可用性百分比等;若回答含糊,会追问直至具体化。第二步是生成文档:按模板输出 1.1 需求概览、1.2 质量目标表和 1.3 干系人表;LEAN 级别保留质量目标、简要功能列表和干系人表,ESSENTIAL 增加业务背景与引用,THOROUGH 增加干系人分类、目标选择理由及与第 10 节的链接。第三步是审查迭代:按清单检查质量目标数量(3–5 个)、每个目标是否有 Q42 标签和可度量场景、是否按优先级排序、是否指明签署责任人,检查需求概览篇幅与业务价值说明,检查干系人是否完整且各有期望,并在其他章节存在时检查跨节一致性。
使用方式为在支持该技能的 AI 工具中调用,技能会以对话方式逐步提问并生成文档草稿,用户可据此反复修改。适用场景包括:新系统架构文档起步、需要规范化质量目标定义、需要梳理干系人及其期望、以及为后续架构决策提供依据。限制方面:资料未提供该技能的具体平台兼容性、安装命令、收费信息或实际效果数据;该技能仅覆盖 arc42 第 1 节,不替代完整架构文档;质量目标的度量指标需由用户自行提供,技能本身不编造数值。