关于 architectural-analysis
architectural-analysis 是用于审查指定范围内软件设计的 Agent 技能，侧重有证据支持的发现，并考虑项目边界与兼容性政策；获得授权后也可指导修复。
主要功能
- 01限定审查范围及相关依赖
- 02依据检测目录分类设计问题
- 03标记死代码前追踪其用法
- 04记录证据、不确定性和最小改动
- 05按请求调整报告详略
适用场景
- 01重构前审查架构
- 02在限定范围内检查依赖和公共导出
- 03整理有证据支持的设计问题
- 04修复已确认且获授权的问题
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/architectural-analysis确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
assets/report-template.mdsummary-template.mdreferences/detection-catalog.md详细介绍
架构分析
审查请求范围，并报告具体的设计问题。单纯审查为只读；如果已有明确授权，可根据审查结果进行整改。评估设计时，请遵循项目的边界和公开兼容性政策。
- 根据请求和上下文确定范围。使用
rg --files、限定范围的rg搜索以及可用的静态分析结果，梳理入口点和相关依赖。不要为每个源文件单独创建一个待办事项，也不要假定项目使用 TypeScript 技术栈。 - 优先关注以下信号：无用导出、职责重复、循环依赖、所有权或类型混乱，以及代价高昂的变更模式。对候选问题进行分类时，请阅读
references/detection-catalog.md中的相应部分；阈值仅供参考，不能据此直接认定存在缺陷。 - 在认定代码无用前，先追踪其使用情况，包括动态加载、反射、框架钩子、测试和已发布的 API。仅仅因为当前检出版本中没有使用者，并不足以证明删除未引用的公开导出是安全的。
- 在源码中确认每项实质性发现。说明其行为或维护成本，引用路径和行号，指出不确定性，并提出最小且有效的改动。如果单独进行通用代码异味扫描没有带来更多证据，就不要这样做。
- 报告篇幅应与请求相称。对于广泛审查，请将
assets/report-template.md作为可调整的大纲，并保存到.audits/architectural-analysis-<timestamp>.md；明确区分已检查和未检查的范围。对于范围较窄的问题，简洁列出发现即可。不得将覆盖不足报告为“未发现问题”。 - 总结重要发现及其证据。现有源文件和摘要模板只是可选的呈现辅助材料，并非必须提交两份报告。
评论
支持 Markdown