如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

自动化缺陷分诊

将每天收到的缺陷报告按优先级整理成清单,再让这项排查工作自动运行。

难度 Intermediate
时间跨度 1h

让 Codex 查看近期的告警、议题、未通过的检查、日志以及聊天中收到的缺陷报告。您可以在同一次聊天中调整缺陷清单,然后安排 Codex 定期排查。

最适合

  • 通过 Sentry 告警、Slack 讨论串、Linear 议题、GitHub 议题、未通过的 PR 检查、支持工单或日志跟踪缺陷的团队。
  • 您希望先在一次 Codex 聊天中手动执行,再安排定期运行的缺陷分诊流程。

目录

    ← 所有使用场景

    自动化缺陷分诊

    将每天收到的缺陷报告按优先级整理成清单,再让这项排查工作自动运行。

    让 Codex 查看近期的告警、议题、未通过的检查、日志以及聊天中收到的缺陷报告。您可以在同一次聊天中调整缺陷清单,然后安排 Codex 定期排查。

    Intermediate
    1h

    让 Codex 查看近期的告警、议题、未通过的检查、日志以及聊天中收到的缺陷报告。您可以在同一次聊天中调整缺陷清单,然后安排 Codex 定期排查。

    Intermediate
    1h

    最适合

    • 通过 Sentry 告警、Slack 讨论串、Linear 议题、GitHub 议题、未通过的 PR 检查、支持工单或日志跟踪缺陷的团队。
    • 您希望先在一次 Codex 聊天中手动执行,再安排定期运行的缺陷分诊流程。

    技能与插件

    • 如果您通过 GitHub 收集缺陷报告,可查看 GitHub 议题、Pull Request、评论、代码审查中的讨论串以及未通过的检查。
    • 如果排查范围包括告警,可查看生产环境中的错误、堆栈跟踪、受影响的版本和事件上下文。
    • 查看团队成员报告缺陷的频道或讨论串,并为团队频道起草摘要。
    • 查看待处理的缺陷队列,查找已有议题,起草进展说明,或在本轮分诊后准备与相应议题关联的后续工单。
    技能 使用理由
    GitHub 如果您通过 GitHub 收集缺陷报告,可查看 GitHub 议题、Pull Request、评论、代码审查中的讨论串以及未通过的检查。
    Sentry 如果排查范围包括告警,可查看生产环境中的错误、堆栈跟踪、受影响的版本和事件上下文。
    Slack 查看团队成员报告缺陷的频道或讨论串,并为团队频道起草摘要。
    Linear 查看待处理的缺陷队列,查找已有议题,起草进展说明,或在本轮分诊后准备与相应议题关联的后续工单。

    起始提示词

    请针对 [repo/service/team] 开展一轮缺陷分诊,排查范围为最近的 [time window]。 使用以下插件:[@Sentry / @Slack / @Linear / @GitHub / none] 输入来源: - Sentry:[project / alert link / none] - Slack:[channel / thread links / none] - Linear:[team / project / view / issue query / none] - GitHub:[repo / issue query / PR checks / none] - 其他:[logs / support tickets / deploy link / dashboard / attached file / none] 输出格式: 先列出所有无法访问的输入来源。 然后列出缺陷,按优先级从 P0 到 P3 排列。 如果没有发现缺陷,请回复“未发现符合条件的缺陷。” 每项缺陷应包含: - 优先级:P0、P1、P2 或 P3 - 标题 - 证据(链接或简短引文) - 建议的下一步行动 规则: - 不得执行任何发布、创建、分派、添加标签、关闭、重新运行或编辑操作。 - 将同一缺陷的重复报告归在一起。 - 将实际观察到的证据与推测分开列出。
    请针对 [repo/service/team] 开展一轮缺陷分诊,排查范围为最近的 [time window]。 使用以下插件:[@Sentry / @Slack / @Linear / @GitHub / none] 输入来源: - Sentry:[project / alert link / none] - Slack:[channel / thread links / none] - Linear:[team / project / view / issue query / none] - GitHub:[repo / issue query / PR checks / none] - 其他:[logs / support tickets / deploy link / dashboard / attached file / none] 输出格式: 先列出所有无法访问的输入来源。 然后列出缺陷,按优先级从 P0 到 P3 排列。 如果没有发现缺陷,请回复“未发现符合条件的缺陷。” 每项缺陷应包含: - 优先级:P0、P1、P2 或 P3 - 标题 - 证据(链接或简短引文) - 建议的下一步行动 规则: - 不得执行任何发布、创建、分派、添加标签、关闭、重新运行或编辑操作。 - 将同一缺陷的重复报告归在一起。 - 将实际观察到的证据与推测分开列出。

    使用方法

    请 Codex 检查平时能发现缺陷的地方,包括 Sentry 告警、Linear 议题、GitHub 议题、PR 检查、部署日志、支持工单和 Slack 讨论串。先手动排查一次,在聊天中调整报告,然后再安排定期排查。

    在同一个 Codex 聊天中完成整个缺陷分流流程:

    1. 按需排查一次,获取缺陷清单初稿。
    2. 检查清单,并在同一聊天中给出反馈。
    3. 在该聊天中为缺陷分流创建计划任务。
    4. 可选:当您对报告有把握时,请 Codex 起草 Linear 议题、Slack 更新消息、GitHub 评论或交接说明。

    开始前,请安装 Codex 所需的插件,例如 Sentry、Slack、Linear 或 GitHub 插件。在起始提示词中,将方括号内的插件列表替换为通过 @ 选中的实际插件标签。然后,将方括号内的每个来源替换为具体的搜索位置,例如 Sentry 项目或告警 URL、Slack 频道或讨论串、Linear 团队、视图或查询、GitHub 代码仓库、议题查询或 PR 检查、部署链接、日志文件、支持工单队列或仪表板。

    第一阶段:排查缺陷

    如果排查需要参考测试、代码仓库工具、构建检查或 CI 失败记录等本地上下文,请从缺陷所属的代码仓库启动 Codex。如果可以通过插件、连接器、MCP 服务器、链接、导出文件、粘贴的日志或附件访问缺陷信息,也可以从任意代码仓库开始排查。

    先使用上面的起始提示词运行一次排查。提示词中只保留本次排查要用的插件和来源。

    例如,您可以在提示词中写明要使用的插件,并列出要排查的具体队列、频道或代码仓库。

    第二阶段:调整报告内容

    在设置自动化之前,请先确认报告值得每天阅读。

    首次排查的报告应符合以下要求:

    • 列出值得关注的缺陷,按 P0 到 P3 的优先级排序。
    • 将同一缺陷的重复报告归在一起。
    • 为每个缺陷附上证据链接或简短引文。
    • 区分推测和已观察到的事实。
    • 为每个缺陷简要说明建议的下一步行动。

    请先在同一聊天中调整报告,再创建计划任务。您可以请 Codex:

    • 在按优先级排序前,再检查一个来源。
    • 过滤掉团队已经知晓、反复出现的告警。
    • 只列出 P0 和 P1 缺陷。
    • 将指向同一缺陷的 Slack 报告、Sentry 告警和 GitHub 失败记录合并。
    • 每个缺陷只展示一个最有参考价值的链接。
    • 补充足够的证据,让其他人能够复现问题或将其转交给合适的人处理。

    第三阶段:设置自动化

    当按需生成的报告符合您的需要后,请留在同一聊天中,为缺陷分流创建计划任务。Codex 可以根据您在聊天中调整好的要求,编写定期运行时使用的提示词。

    为缺陷分流创建计划任务

    请为我们在这个聊天中完善的缺陷分流流程创建计划任务。 运行时间:[every hour / every weekday morning / daily] 沿用这个聊天中确定的信息来源、优先级规则、重复报告的归并方式、证据呈现方式和 P0-P3 报告格式。 编写计划任务的提示词时,请在其中提及所需插件,或说明如何访问已连接的数据源,以便任务运行时能再次读取这些来源。 计划任务只能生成草稿。不要发布内容、创建条目、分派任务、添加标签、关闭条目、重新运行任务、着手修复或编辑代码。 在创建计划任务之前,请先向我展示任务提示词、运行时间、信息来源和操作策略。

    第四阶段:安排后续处理

    当计划任务生成的报告符合您的需要后,再决定将后续工作交给谁处理。Codex 可以为团队的 Slack 频道起草更新消息,为您想跟踪的缺陷拟写 Linear 议题,为检查失败的 PR 撰写 GitHub 评论,或为值班人员准备交接说明。

    请更新在这个聊天中创建的缺陷分流计划任务。 每次按计划运行后,请起草我需要的后续内容: - 面向 [channel] 的 Slack 更新消息 - 用于跟踪 [which bugs should become issues] 的 Linear 议题 - 针对 [issue / PR / failing check] 的 GitHub 评论 - 给 [team / on-call / owner] 的交接说明 规则: - 先在 Codex 中起草后续内容。 - 只有在我明确批准相应操作后,才可以在 Slack 发布消息、创建 Linear 议题或在 GitHub 发表评论。 - 如有现成的 Linear、GitHub、Slack 或告警来源链接,请一并附上。 - 对于任何未经明确批准的操作,只准备草稿。

    技术栈

    需求

    缺陷信息来源

    默认选项

    Sentry 告警、Slack 频道、Linear 视图、GitHub 议题、PR 检查、支持工单队列、值班记录、日志、仪表板和部署记录

    为什么需要

    列出 Codex 应排查的具体队列、频道、视图、代码仓库、告警链接、仪表板和文件。

    需求

    Codex 如何读取缺陷信息

    默认选项

    适用于 Slack、Linear、GitHub 和 Sentry 的 插件 、连接器、 MCP 服务器 、代码仓库 CLI、链接、导出文件、附件和粘贴的日志

    为什么需要

    如果有现成的集成,请先安装。对于 Codex 暂时无法读取的内部数据源,您可以搭建或配置小型 MCP 服务器、开发 CLI 工具、设置数据导出或提供仪表板链接。

    需求 默认选项 为什么需要
    缺陷信息来源 Sentry 告警、Slack 频道、Linear 视图、GitHub 议题、PR 检查、支持工单队列、值班记录、日志、仪表板和部署记录 列出 Codex 应排查的具体队列、频道、视图、代码仓库、告警链接、仪表板和文件。
    Codex 如何读取缺陷信息 适用于 Slack、Linear、GitHub 和 Sentry 的 插件 、连接器、 MCP 服务器 、代码仓库 CLI、链接、导出文件、附件和粘贴的日志 如果有现成的集成,请先安装。对于 Codex 暂时无法读取的内部数据源,您可以搭建或配置小型 MCP 服务器、开发 CLI 工具、设置数据导出或提供仪表板链接。

    相关使用场景