关于 octopus-architecture
octopus-architecture 是供 Codex CLI 使用的架构审查技能，依据实现、调用方、测试、变更记录和失败行为提出接口建议。它可比较设计方案并给出决策，但不会授权自动重构。
主要功能
- 01基于证据审查架构
- 02检查调用方、测试与源码历史
- 03比较两种设计方案
- 04说明迁移与测试影响
- 05可选的有限独立审查
适用场景
- 01审查拟议的模块边界
- 02结合调用方和测试评估简化方案
- 03比较针对已展示扩展需求的设计
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/octopus-architecture确认已加载。
附带文件agents/openai.yaml
详细介绍
宿主：Codex CLI — 此技能为 Claude Code 设计，并已适配 Codex。 交叉引用命令在 Codex 中使用已安装的技能名称，而不是
/octo:*斜杠命令。 使用当前 Codex shell 和子 Agent 工具。除非当前会话已提供相应能力，否则不要声称某个提供方、模型或宿主子 Agent 可用。 宿主工具的对应项请参见skills/blocks/codex-host-adapter.md。
架构审查
从已安装的插件中加载 skills/blocks/engineering-method-selection.md，
并仅应用与此任务相关的方法。保留此入口的执行约定
和输出格式。将引用的技能作为指令阅读；
不要递归调用当前命令，也不要从座席添加提供方调用。
在当前宿主上运行此方法。常规架构审查不会额外派发任何提供方。
--peer-review、明确要求独立审查，
或现有风险策略可能会通过 Octopus 路由添加一位有界外部审查者。如果该审查者无法
读取源代码，或未能提供有依据的意见，请报告独立审查覆盖不完整。
方法
从已安装的插件根目录读取并应用 skills/blocks/architecture-simplification.md。
确定源代码版本，并在建议边界之前检查实现、调用方、测试、
近期变更和故障行为。
对于单项简化，提出一个有证据支持的接口。对于设计选择，基于相同的不可变需求 提出两个备选方案：
- 草案 A 尽可能减少调用方需要了解的信息和配置。
- 草案 B 让下一个已证实的扩展更容易实现。
将两个由宿主生成的草案标注为同一模型生成的相关备选方案。如果授权了 独立审查者，则向其发送相同的源代码和需求，但在其首次回复之前 不发送草案 A。传输方式不同并不能证明模型家族不同。家族未知即表示独立性未知。
完成
返回 Evidence、Caller contract、Proposed interface、Migration、Test impact 和 Decision。Decision 的值为 keep、simplify 或 investigate。
简化需要精确的源代码证据和具体的调用方示例。设计审查绝不授权自动重构。
LSP 集成
当宿主提供语言服务器工具时，在提出接口之前，使用文档符号、工作区 符号、定义和引用来确认模块边界和调用方关系。将 LSP 结果视为索引： 对重要论断通过源代码和测试进行核实；如果语言服务器不可用或结果不完整，则改用 代码仓库搜索。
改编自 mattpocock/skills 中的 codebase-design 和 DESIGN-IT-TWICE，对应提交
3cca18b368ae95cdbdebbff572ccafa662551015，遵循 MIT 许可证。请参见
THIRD_PARTY_NOTICES.md。