skill-issues 是一个跨会话的问题跟踪技能,核心流程为“跟踪 → 解决 → 学习”。问题统一存放于项目根目录的 .octo/ISSUES.md,可在多次会话间保留。
主要能力:列出所有未解决问题,以表格展示 ID、严重度、类别、描述、创建日期和阶段;添加新问题并自动生成 ID(格式 ISS-YYYYMMDD-NNN),添加前会询问严重度和类别;解决指定问题,记录解决日期与解决说明,并将条目移入已解决区;查看单个问题详情,包括状态、严重度、类别、描述及对应操作。列出问题后,若同一类别出现 3 个及以上未解决问题,会提示可能存在系统性问题。
严重度分为 critical、high、medium、low;类别包括 logic-error、integration、quality-gate、security、performance、ux、architecture。
使用方式:默认命令列出问题,add 添加,resolve 解决,show 查看详情。首次使用或文件不存在时,会创建 .octo 目录并从模板复制初始化 ISSUES.md,模板中的 {{PROJECT_NAME}} 会替换为当前目录名。添加或解决时只追加或改单条,不覆盖已有内容。ID 生成会扫描当天已有编号并递增。添加问题时会从 .octo/STATE.md 读取 current_phase,若不存在则阶段为 Unknown。
适用场景:开发中发现需要稍后处理的问题、记录阶段性阻塞、跨会话复查未解决问题。不适用于 GitHub issue 管理、Git 跟踪的问题或临时待办。
限制:该技能原为 Claude Code 设计并适配 Codex;在 Codex 中交叉引用使用已安装技能名,而非 /octo:* 斜杠命令;在会话未暴露前,不应声称某提供方、模型或宿主子代理可用。其他细节暂未提供。