hw:architecture

hw:architecture

生成硬件/嵌入式项目的整体架构文档。该文档是 OpenSpec 前置输入层，用于约束后续 hw:change-plan 和每个 aisee-device-spec-driven change。

本技能合并原 hw:interfaces 与 hw:design 的主职责：接口、资源、模块、算法、运行时和全局规则必须在同一份整体架构里统一判断。

Inputs

必需：

• aisee/docs/requirements/*-hw-srs.md

可选但强烈建议：

• docs/project-structure.md
• docs/clock-contract.md
• docs/memory-device-contract.md
• 原理图、PCB、器件手册、旧项目接口表、Linux dts、协议文档
• 已有工程源码、map、启动文件、linker/scatter、工程宏

可选参数：

• --mode standard|deep|review，默认 standard
• --focus interfaces|modules|algorithm|resources|all，默认 all

References

需要接口和资源检查时读取：

references/architecture-checklist.md

生成文档时读取：

assets/architecture-template.md

模块数量 >=5 时读取：

assets/module-architecture-template.md

Output

保存到：

aisee/docs/architecture/<YYYY-MM-DD>-<slug>-hw-architecture.md

模块数量 >=5 时还必须生成：

docs/modules/<module-name>.md

必须包含：

• SRS 和工程事实来源
• 项目类型与运行形态
• 最终硬件/平台方向
• 全局接口与资源分配：引脚、外设、总线、地址、电源、复位、中断、DMA
• 时钟/时序策略：采样率、通信速率、控制周期、tick、延时基准
• 存储与型号策略：Flash/RAM/heap/stack/map/linker/startup/同系列换型规则
• 模拟前端、传感器、执行器、电源和机械约束
• 软件/固件模块划分
• 数据流、控制流、状态机、启动/复位/异常恢复
• 算法链路、库选择、替代方案和放弃方案
• 资源预算与依据
• 全局验证策略
• 可变更项、禁止偏离项、变更影响评估规则
• 给 initialize-hardware-project change 的工程骨架输入
• 给 hw:change-plan 的拆分提示和 OpenSpec source-map seed 线索

Phase 0 - Read Inputs

PowerShell:

Get-Content -ErrorAction Stop aisee/docs/requirements/*-hw-srs.md
Get-Content -ErrorAction SilentlyContinue docs/project-structure.md
Get-Content -ErrorAction SilentlyContinue docs/clock-contract.md
Get-Content -ErrorAction SilentlyContinue docs/memory-device-contract.md
rg --files | rg '(\.ioc$|\.uvprojx$|\.ewp$|\.eww$|CMakeLists\.txt$|\.map$|\.sct$|\.ld$|\.icf$|startup_.*\.s$)'

POSIX shell:

cat aisee/docs/requirements/*-hw-srs.md
cat docs/project-structure.md 2>/dev/null
cat docs/clock-contract.md 2>/dev/null
cat docs/memory-device-contract.md 2>/dev/null
rg --files | rg '(\.ioc$|\.uvprojx$|\.ewp$|\.eww$|CMakeLists\.txt$|\.map$|\.sct$|\.ld$|\.icf$|startup_.*\.s$)'