{
  "scenario": "research-investigation",
  "locale": "zh-CN",
  "version": "1.0.0",
  "syntax": "handlebars",
  "syntaxVersion": "1.0",
  "author": "PCode Team",
  "description": "在选定的 CodeRef Vault 中执行代码调研：按需在 repos/ 下 clone 或更新仓库，围绕调研方向分析代码，并把结论沉淀到 docs/。",
  "image": {
    "stageStyleKey": "custom-executor-research-investigation",
    "artStyle": "代码库田野调研任务卡",
    "displayMode": "story-card",
    "aspectRatio": "4:3",
    "alt": "在选定的 CodeRef Vault 中执行代码调研：按需在 repos/ 下 clone 或更新仓库，围绕调研方向分析代码，并把结论沉淀到 docs/。",
    "stageStyleLabel": "调研任务卡",
    "promptDirection": "coderef 调研、仓库引入、文档沉淀"
  },
  "lastModified": "2026-04-14",
  "tags": [
    "research",
    "coderef",
    "CustomExecutor"
  ],
  "parameters": [
    {
      "name": "projectPath",
      "type": "string",
      "required": true,
      "description": "所选 CodeRef Vault 根目录的绝对路径。"
    },
    {
      "name": "repositoryPath",
      "type": "string",
      "required": false,
      "description": "解析后的目标路径提示。对于 vault 目标，通常与解析后的 Vault 根路径一致。"
    },
    {
      "name": "targetType",
      "type": "string",
      "required": false,
      "description": "执行目标类型。调研请求预期使用 vault。"
    },
    {
      "name": "vaultId",
      "type": "string",
      "required": false,
      "description": "兼容过渡期保留的旧版输出 Vault 标识别名。"
    },
    {
      "name": "vaultName",
      "type": "string",
      "required": false,
      "description": "兼容过渡期保留的旧版输出 Vault 展示名称别名。"
    },
    {
      "name": "vaultType",
      "type": "string",
      "required": false,
      "description": "兼容过渡期保留的旧版输出 Vault 类型别名。"
    },
    {
      "name": "outputVaultId",
      "type": "string",
      "required": false,
      "description": "本次调研所选输出 CodeRef Vault 的显式标识。"
    },
    {
      "name": "outputVaultName",
      "type": "string",
      "required": false,
      "description": "输出 CodeRef Vault 的展示名称。"
    },
    {
      "name": "outputVaultType",
      "type": "string",
      "required": false,
      "description": "运行时输出 Vault 的类型元数据，预期值为 coderef。"
    },
    {
      "name": "researchDirection",
      "type": "string",
      "required": true,
      "description": "本次调研的明确目标，决定执行器需要重点分析的内容。"
    },
    {
      "name": "repositoryUrls",
      "type": "array",
      "required": false,
      "description": "按顺序提供的 Git 仓库 URL，执行器需要先在 repos/ 下 clone 或更新它们。"
    },
    {
      "name": "referenceVaults",
      "type": "array",
      "required": false,
      "description": "只读参考 Vault 摘要列表，包含 id、name、type 和 physicalPath，用于补充证据上下文。"
    },
    {
      "name": "targetProjects",
      "type": "array",
      "required": false,
      "description": "补充只读项目引用列表，包含 projectId、name、physicalPath 和 accessType。调研项目引用仅作为参考范围。"
    },
    {
      "name": "reposDirectory",
      "type": "string",
      "required": false,
      "description": "CodeRef Vault 内 repos/ 工作区的绝对路径。"
    },
    {
      "name": "docsDirectory",
      "type": "string",
      "required": false,
      "description": "CodeRef Vault 内 docs/ 输出区的绝对路径。"
    }
  ],
  "dungeon": {
    "enabled": true,
    "scriptKey": "autotask.research-investigation",
    "groupKey": "autotask",
    "sortOrder": 230,
    "displayNameKey": "hero.dungeon.catalog.autotask.researchInvestigation.name",
    "descriptionKey": "hero.dungeon.catalog.autotask.researchInvestigation.description",
    "displayName": "代码调研",
    "description": "用于 CodeRef 调研任务的运行时成员路由配置。"
  }
}
