architecture-docs
该技能用于为人类读者编写或重构高层架构文档,帮助快速理解系统的主要组成部分、它们之间的连接方式,以及请求、任务或数据如何在系统中流动。它强调可视化优先、简洁易懂,默认将架构文档放在 docs/architecture/ 目录,并建议在文档顶部使用简单的 Mermaid flowchart TD 图。技能还区分架构文档与参考文档:架构文档关注系统形态、边界、流程和主要权衡,而精确字段名、环境变量、限制、命令、模式等细节应放入 docs/references/。适用于需要解释系统工作原理、主要部分如何连接、数据或请求如何流转,以及重要边界与职责划分的场景。