# opsxshell docs

开发规则以根目录 [AGENTS.md](../AGENTS.md) 为准，[CLAUDE.md](../CLAUDE.md) 为短入口。

- [架构说明](architecture.md)：当前分层、状态与原生生命周期
- [架构重构](architecture-refactor.md)：已完成部分与待实施轨道
- [测试与验收](testing-acceptance.md)：巡检、针对性测试和实机验收
- [使用指南](user-guide.md) · [发布](release.md)

以下为 AI 专题：

| 文档                                                                  | 说明                                      |
| --------------------------------------------------------------------- | ----------------------------------------- |
| [01-AI-Agent步数预算与incomplete](01-AI-Agent步数预算与incomplete.md) | MAX_AGENT_STEPS=12 与 incomplete/续跑目标 |

跨产品契约以 aiops/opsxcli 的 `13-运行结果状态与可续跑契约.md` 为准。

- [02-运行中消息排队](02-运行中消息排队.md) — 忙时排队 / 立即 / 编辑 / 撤销

## SDD（何时必填）

模板：[sdd-template.md](sdd-template.md)。成品落点：[sdd/](sdd/)（`docs/sdd/`）。

| 级别    | 何时                                                         | 要不要 SDD                                   |
| ------- | ------------------------------------------------------------ | -------------------------------------------- |
| S0 / S1 | 文案、图标、换链、单点小修                                   | 免。BACKLOG 或提交说明够用                   |
| S2 / S3 | 跨模块、有契约 / 风险 / 发布（新能力、协议、存储、安全边界） | **必填**。从模板拷到 `docs/sdd/`，填完再开工 |

UI 刀在模板「验收标准」里加一行观感 / 交互过线口径即可，不必另起设计专章。