SuperAPI AI 工具集

codex

智能体与模型

查看项目

更新于 10-16 23:14

技能介绍

用途

Codex 用于在已有的开发或评审流程中引入来自 OpenAI Codex CLI 的“第二意见”。它作为 gstack 技能集的一部分,通过三种不同模式对当前任务、代码或方案进行独立分析,帮助发现单一视角可能遗漏的问题。

主要能力

技能提供三种模式:

  • Review:作为通过/不通过的质量门禁。
  • Challenge:以对抗方式查找边界情况。
  • Consult:自由形式的咨询,支持会话连续性。 该技能为只读,并提供流式输出和思考轨迹(thinking traces)。当 review 已经运行过时,可以进行跨模型分析。

使用方式

技能引用了上游文档,并声明在指定修订版本上参照这些文档。运行时会先执行 Preamble,其中包括:检查更新、创建会话目录、清理过期会话文件、读取配置(贡献者模式、主动建议开关)、输出当前分支、输出 PROACTIVE 值、检测仓库模式(solo/collaborative/unknown)、检查是否已看过完整性原则介绍(LAKE_INTRO)、处理遥测提示状态等。根据这些输出值,技能会决定是否提示用户关于完整性原则和遥测选项。

技能还定义了 AskUserQuestion 的固定格式要求:先重述项目、当前分支和计划/任务;用通俗语言解释问题;给出推荐(RECOMMENDATION)并标注完整性评分(Completeness: X/10);最后列出带字母的选项,涉及工作量时同时给出人类团队与 CC+gstack 两种时间尺度。

技能中包含“完整性原则——Boil the Lake”,建议在 AI 辅助编码使完整实现的边际成本接近零时,优先选择完整方案而非捷径,并给出不同任务类型的人类团队与 CC+gstack 时间压缩对照表。

技能还定义了仓库所有权模式(solo/collaborative/unknown)下发现问题时的处理策略,以及“See Something, Say Something”原则:在任意工作流步骤中发现异常都应简要指出,solo 模式下可主动提出修复,协作模式下仅提示。

此外,技能包含“Search Before Building”理念,将知识分为三层(成熟可用、新且流行、第一性原理),并给出 Eureka 时刻的记录命令。若 WebSearch 不可用,则跳过搜索并注明仅使用分发内知识。

贡献者模式下,技能要求在每个主要工作流步骤结束后对 gstack 工具进行 0–10 评分,若发现可操作的缺陷或有价值的改进点,则按指定模板撰写报告到 ~/.gstack/contributor-logs/{slug}.md,每会话最多 3 份。

技能定义了完成状态协议,使用 DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT 四种状态报告,并给出升级(Escalation)格式与适用情形(如同一任务尝试 3 次未成功、安全敏感变更不确定、工作范围超出可验证能力时应停止并升级)。

工作流完成后会运行遥测记录命令,将技能名称、耗时、结果等写入 ~/.gstack/analytics/。在 plan 模式下,若计划文件尚无 ## GSTACK REVIEW REPORT 段,则运行 gstack-review-read 并写入审查报告表格。

适用场景

适用于希望在开发或评审流程中引入 OpenAI Codex CLI 作为独立第二意见的场景,尤其是需要质量门禁、对抗式边界查找或带上下文的自由咨询时。

限制

该技能为只读操作。资料未提供具体收费、价格、平台兼容性或效果数据,这些信息暂未提供。技能行为依赖上游文档的指定修订版本,并包含本地配置读取、遥测与贡献者报告等机制。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明