用途
uw-analyze-infrastructure 用于分析重建项目时必须复现的基础设施内容。它针对的是“不属于代码层、但重建仍依赖”的文件:构建与依赖清单、运行时配置、程序入口与启动装配、部署与运维资产、项目脚本以及顶层文档。其目标不是描述当前部署如何运营,而是记录重建必须满足的约定(依赖、环境变量、端口、部署拓扑)。
主要能力
- 将基础设施相关文件归类并按四个分节组织:build.md(构建系统、包清单、依赖、脚本)、configuration.md(运行时配置:环境变量、属性文件、yaml/yml、.env 模板、功能开关)、entrypoints.md(程序引导/main/应用装配、绑定端口)、deployment.md(容器、IaC、CI/CD、运维脚本)。
- 输出到 docs/unwind/layers/infrastructure/,包含 index.md 与分节文件;若某节无内容可省略,但需在 index.md 注明,且每个候选条目都必须被记录。
- 采用增量写入:每一步写完立即更新 index.md,最后汇总计数与一段概述。
- 使用锚点 ID 标题(例如 <!-- id: file:package.json:package.json -->)以便机械校验覆盖率。
- 强制标注 [MUST]、[SHOULD]、[DON'T]:依赖清单、运行时配置、程序入口、部署拓扑与运行时要求标为 MUST;开发/构建脚本、linter/formatter 配置、CI 工作流标为 SHOULD;编辑器设置、锁文件、生成产物标为 DON'T。
- 支持刷新模式:若目录已存在,则在 index.md 中添加“Changes Since Last Review”节,而非覆盖。
使用方式
按步骤执行:先创建目录并写初始 index.md 骨架;再依次编写 build.md、configuration.md、entrypoints.md、deployment.md,每步写完后更新 index.md;最后完善 index.md 的最终计数与概述。输出格式要求标题带锚点 ID、提供源文件链接、用表格记录依赖(名称+版本)、配置键(默认值+控制内容)等。
适用场景
适用于需要为项目重建整理基础设施约定的场景,例如迁移、重写或复刻一个项目时,系统性记录构建依赖、运行时配置、程序入口与部署拓扑。
限制
资料未说明该技能的具体运行环境、安装方式、命令行调用形式或收费信息。文档中要求遵循 analysis-principles.md 的原则(完整性、机器可读、链接源文件、无评论、增量写入、锚点 ID 标题),但该文件内容暂未提供。