用途:该技能用于在 .NET 项目中开展 CodeQL 安全分析,当仓库需要 CodeQL 查询包、对开源代码库进行 CLI 分析,或计划把 GitHub code scanning 纳入 CI 时使用。定位是安全分析工具,而非代码风格检查器。
主要能力:产出具体的项目变更(代码、文档、配置、测试、CI 或审查产物);通过先规划、再验证、最后校验的方式降低不确定性;沉淀可复用的项目上下文。
触发条件:仓库使用或打算使用 CodeQL 做 .NET 安全分析;GitHub code scanning 属于 CI 计划的一部分。
不适用:需要无私有仓库授权限制工具的场景。
输入:最近的 AGENTS.md;托管模型(开源仓库、私有仓库或手动 CLI 工作流);当前 GitHub Actions 工作流。
快速开始:阅读最近的 AGENTS.md 并确认范围与约束;通过 Ralph Loop 执行工作流直至结果可接受;按 Required Result Format 返回具体产物与验证证据。
工作流要点:在把 CodeQL 提议为默认门禁前,明确授权与托管模型;精度重要时,对编译型 .NET 项目优先使用手动构建模式(manual build mode)。
未配置时的引导:用 rg -n "codeql-action|security-events|CodeQL" .github/workflows 与 command -v codeql 检测现状;仓库扫描优先采用 CI 优先方案,使用 github/codeql-action/init 和 github/codeql-action/analyze;在工作流中配置显式 .NET 构建模式(精度重要时用手动模式);仅在需要本地查询工作时才加入本地 CLI 用法;运行工作流或本地分析路径并返回 configured 或 improved 状态;若授权或托管限制不适合该仓库,返回 not_applicable 并记录该限制。
交付:显式 CodeQL 配置,或带说明的显式拒绝;可在该仓库复现的 CI 或本地命令。校验:所选路径对仓库类型允许;构建模式有文档且可复现。
Ralph Loop:每个任务先规划(分析现状、定义目标与约束风险、写执行计划、列出最终校验技能及顺序),再执行一步产出具体变更,审查并记录可执行修复项,小批量修复并重跑检查,迭代更新计划直至结果可接受。依赖缺失时引导或返回 not_applicable 并说明原因与回退路径。结果格式含 status、plan、actions_taken、validation_skills、verification、remaining。仅配置类请求返回 status: configured 与确切后续命令。参考文件包括 references/codeql.md、references/queries.md、references/workflow.md。示例请求:“Set up CodeQL for this public .NET repo.” 与 “Explain the CodeQL caveat for private repos.” 资料未提供具体授权条款、价格与平台限制细节,暂未提供。