用途：当用户要求调查、探索、理解、解释或分析某个已有功能或逻辑如何工作时使用。该技能以只读方式探索代码，构建理解并给出解释，不修改任何代码。若需实现功能应改用 feature-implementation，调试则用 debug-investigate。
主要能力：按工作流分阶段执行——Setup 创建分析文件并定义调查范围；Discovery 用 Glob/Grep 在前后端查找相关文件；Deep Analysis 逐个阅读文件并构建关系知识图谱；Synthesis 梳理工作流、集成点、数据流与业务逻辑；Report 以证据链和代码引用呈现结论。要求每条结论都有代码证据，无法证明的标记为 inferred 并给出置信度；每 10 次操作重读原始问题以防上下文漂移。
使用方式：在 Codex 中用 $skill-name 调用仓库技能。执行前需创建并同步任务跟踪，逐步报告证据；若某步骤或工具在当前环境无法运行，应先停止并询问用户。需先阅读项目参考文档，如 docs/project-config.json、docs/project-reference/docs-index-reference.md、lessons.md，并按任务类型选择性打开后端、前端、测试或评审相关文档。分析文件建议放在 .ai/workspace/analysis/[feature-name]-investigation.analysis.md。
适用场景：回答“功能 X 如何工作”“逻辑 Y 在哪里”“发生 Z 时会发生什么”“为什么 A 表现为 B”等调查问题，覆盖 CQRS、事件驱动、消息总线消费者、前端组件与状态管理等模式。
限制：严格只读，不得修改代码；不得跳过、重排或合并协议步骤，除非用户明确批准；不得凭空推测，所有关系需实际调用路径证据；具体项目路径、命令与模块配置以项目文档为准，资料未提供统一固定值。