文档与架构决策记录

关于这个 Skill

记录架构决策、API 契约与项目指南，并保留背景、替代方案及权衡。记录决策背景与替代方案，在实际使用处更新文档，并核对文字与真实行为。

为什么推荐

Addy Agent Skills 中的任务工作流。遵循上游指令并保留引用的共用文件；实际可执行步骤取决于宿主能力和项目配置。

适合用来做什么

• 后续协作者需要理解设计选择的原因。

方法与交付

记录决策背景与替代方案，在实际使用处更新文档，并核对文字与真实行为。

架构决策记录、API 文档或更新后的项目指南，保留来源细节与限定条件。

文档与架构决策记录指令

保留所需参考资料

需要共用参考资料时，采用上游说明的完整仓库接入方式。skills CLI 的单项安装只复制 skills/<name>/，可能缺少仓库级 references/ 检查清单；应保留工作流所需的共用文件。

上游说明与接入方式

使用前需要了解

• 需要能加载 Skill Markdown 并访问项目的 Agent；文件编辑、命令、构建与检查依具体工作流和环境而定。
• 使用项目自身的运行环境、依赖与验证命令；Skill 文件提供操作指引，不会替项目安装工具。
• 需要共用参考资料时，采用上游说明的完整仓库接入方式。skills CLI 的单项安装只复制 skills/<name>/，可能缺少仓库级 references/ 检查清单；应保留工作流所需的共用文件。

支持的 Agent