octocode-plan 是一个偏工作流编排的技能，目标是在动手写代码前，先理解问题、做证据化研究，再把研究结论综合成可执行的实施计划。它适用的触发场景包括用户提出“plan & implement”“plan this work”“research & build”“plan auth/API/work”等，或任务本身需要多步骤、跨文件、跨仓库的流水线。
主要能力：按 理解→研究→规划→[实施]→验证 推进；先识别可用的研究工具，优先把研究委派给 octocode-researcher（本地代码库、LSP 定义/引用/调用）和 octocode-research（外部仓库、包、PR）；用任务/待办跟踪器记录规划进度；在宿主支持时用并行子代理机制处理互不相关的仓库或子系统。研究结论按置信度分级（单一权威来源或一致多来源为高，单一非权威来源为中，冲突或无来源为低），并遵循“双来源规则”。
使用方式：技能会读取 .octocode/context/context.md 获取用户偏好与项目上下文；研究结果与计划分别写入 .octocode/plan/{session-name}/research.md 和 plan.md，纯研究目标可产出 output.md。写文件前必须先在对话中给出摘要，并征得用户明确同意，不允许未经批准创建文档。进入实施阶段前必须获得用户对计划的明确批准。文件中给出的 Octocode MCP 安装方式为在 MCP 配置中加入 {"mcpServers": {"octocode": {"command": "npx", "args": ["-y", "octocode-mcp"], "env": {"ENABLE_LOCAL": "true"}}}，然后重启编辑器；本地检索无结果时可提示添加 ENABLE_LOCAL=true。验证阶段对代码变更要求构建、lint、测试通过且无 TypeScript 错误，失败则循环修复直到通过。
限制：文档未提供价格、平台支持范围或效果保证。若宿主运行时不支持技能间委派或并行子代理，则改用等价的本地/外部研究工具并保持同样的证据标准，或按依赖顺序串行执行。规划阶段不应并行；共享类型或可变状态的任务不应并行。范围不清或涉及超过两个仓库时需停下并询问用户。明确禁止给出时间/时长估算；任务只有在验证阶段确认副作用成功（文件已写、测试通过、构建成功）后才能标记完成。