工程开发
architecture-status avatar

architecture-status

分析架构文档的健康状况,包含 ADR、审查活动与文档缺口,并提供包含具体建议的状态报告。

简介

architecture-status 技能作为 AI 软件架构框架的自动化健康检查工具。它会扫描 .architecture/ 目录以评估架构决策记录 (ADR)、同行与专家审查、重新校准进度以及团队组成的状态。此技能专为工程团队与技术负责人设计,提供项目文档质量的集中概览,有助于在软件开发生命周期中维持架构严谨性。

  • 对 ADR 文件进行全面审计,计算采纳、弃用与提案状态。

  • 总结架构审查活动,区分功能、版本与专家审查类型。

  • 追踪重新校准计划,监控架构审查如何转化为实现任务。

  • 分析文档覆盖范围,找出安全性、基础设施与系统设计等领域的缺口。

  • 生成结构化的 Markdown 报告,包含关键指标摘要、近期活动记录以及基于文档健康指标的具体行动建议。

  • 根据现有缺口为用户提供智能指引,例如是否应建立新 ADR、启动审查或咨询专家。

  • 通过扫描本地 .architecture/ 目录运行;需要先初始化 AI Software Architect 框架。

  • 根据文档更新频率与近期活动,提供从「极佳」到「未启用」的健康评级。

  • 最适合在冲刺 (Sprint) 开始、重大发布前或项目转换期间使用,以确保架构一致性。

  • 若未检测到框架,系统会提示用户执行设置指令,如 'Setup ai-software-architect'。

  • 与 Claude Code、Cursor 与 GitHub Copilot 等 AI 编码助手无缝整合,维持架构演进的单一事实来源。

  • 输入为 .architecture/ 目录中的现有文件状态;输出为适用于团队更新或仓库文档的纯文本或 Markdown 报告。

  • 专注于诊断报告与流程健康洞察,不会与文档创建或专业审查工具产生冲突。

仓库统计

Star 数
60
Fork 数
9
Open Issue 数
3
主要语言
JavaScript
默认分支
main
同步状态
空闲
最近同步时间
2026年5月1日 10:02
在 GitHub 查看