用途:Remediation Planner 是 Endor Agent Kit 生成的技能(recipe remediation-planner v0.1.0),用于从 Endor 升级建议、针对具体 finding 的修复项和预览证据中,找出最安全的依赖修复路径。它只输出计划,不打开 PR。
主要能力:解析项目上下文(当前仓库、owner/repo、仓库 URL、Endor 项目名、finding UUID 或可选项目 UUID);通过所选 Endor Knowledge Pack 任务配置的证据查询计划收集修复选项;对选择计划先查询 VersionUpgrade/UIA 摘要,再按需获取 Finding 详情;构建包含所选方案与备选方案的 dry-run 预览计划;输出结构化 JSON,含 project_resolution.status、evidence_queries、remediation_options、selected_remediation、data_gaps。
使用方式:在 Cursor 宿主集成下使用,仅使用只读文件与 shell 工具。项目作用域查询默认 context.type==CONTEXT_TYPE_MAIN。命名空间需显式解析并记录来源,按用户指定、ENDOR_NAMESPACE 环境变量、默认 ~/.endorctl/config.yaml、已解析项目元数据的顺序确定;作用域查询需显式传 -n <namespace> 或 --namespace <namespace>。示例查询:endorctl api list -r VersionUpgrade -n <namespace> --filter 'context.type==CONTEXT_TYPE_MAIN and spec.project_uuid=="<PROJECT_UUID>" and spec.upgrade_info.worth_it==true' --field-mask "uuid,spec.name,spec.upgrade_info" --list-all -o json。
适用场景:需要在不产生变更的前提下评估依赖升级修复方案、比较备选路径、核对 Endor 证据时。
限制:工作流严格只读,不编辑文件、不运行会变更状态的包管理命令、不创建分支/提交/推送/PR/MR、不发表评论、不修改 Endor 策略或状态。仅使用 Endor 证据,本地文档、README、CLAUDE.md、仓库路径、缓存笔记和模型记忆只能作为上下文,不能证明 finding 数量、受影响文件、UIA 候选、项目 UUID、命名空间或仓库 URL。证据缺失时须记入 data_gaps,不得估算或推断。不要求、不配置、不启动 Endor MCP 服务器。若宿主无法检查本地 git,需向用户询问仓库 URL、owner/repo 或 Endor 项目名。最终输出不得包含原始命令。