octocode-engineer 是 bgauryy/octocode 下的系统级工程技能，用于端到端理解代码库、调查缺陷、重构、评估 PR 安全、审查架构并对照真实代码验证 RFC。它强调单文件阅读难以发现根因，根因常位于边界、控制流归属、契约、数据路径与运行时假设中。
主要能力：产出结构化的“理解工件”，包含系统摘要、控制流、数据流、类型与协议、边界与所有权、结构健康度、重复清单、执行画像、架构健康度与下一步；针对变更给出变更流、数据流影响、契约影响、爆炸半径与风险向量。它以 Clean Architecture 五项原则与六类分析维度（流、重复、类型、协议与 schema、数据流、执行）为必备视角。
使用方式：以自然语言触发，例如“理解这个代码库”“深入分析某功能”“审查 X 的架构”“这个 PR 安全吗”“改 Y 会破坏什么”“准备重构 Z”“对照代码验证该 RFC”。工具链包括本地 Octocode 工具、LSP、AST 脚本与扫描器；例如查找定义用 localSearchCode 后接 lspGotoDefinition，查找调用方用 lspCallHierarchy，评估影响范围用 lspFindReferences，结构检查用 scripts/ast/search.js --preset，架构扫描用 scripts/run.js --graph。LSP 调用需先有 lineHint，不可猜测；Octocode MCP 注册期间不应回退到原生搜索工具。
适用场景：任意语言的代码库理解、质量与架构评审、技术债与死代码排查、安全与构建问题、架构决策及 RFC 验证；对 Node/TypeScript 与 Python 支持最强。
限制：非平凡任务才受完整契约约束；平凡任务仅需一行下一步与验证。公共契约变更、跨层编辑、破坏性动作或大爆炸半径时会停在硬性闸门等待用户决策。资料未提供安装命令、收费与价格、支持平台等细节。