SuperAPI AI 工具集

document-issues

办公与效率

查看项目

更新于 10-16 05:05

技能介绍

用途:在 git 仓库中工作时,把与当前任务无关但值得日后跟进的问题记录下来,避免遗忘或在当前改动中夹带无关变更。

主要能力:默认以 GitHub issue 作为记录系统;除非用户已为当前会话显式开启自主创建,否则创建前先征求确认。nytid todo 导入被视为创建 GitHub issue 之后的可选第二步,而非默认路径。只记录与当前任务无关、描述清晰可执行、日后有价值的问题,例如无关 bug、顺带发现的缺失测试、不应并入当前改动的清理或重构项、误导性文档或注释、工具链或 CI 阻力;当前任务本身已覆盖、观察过于模糊、无仓库上下文、仓库非 GitHub 托管或 issue 功能不可用时不应创建。

使用方式:先确认是否需要记录,未开启自主创建时先问一句。随后验证仓库与 GitHub 上下文,运行 git rev-parse --is-inside-work-tree,并用 gh repo view --json nameWithOwner,url,hasIssuesEnabled 确认 issue 已启用;失败或未启用则不创建 GitHub issue。接着用关键词搜索 gh issue list --state all --search "<keywords>" --json number,title,url,body 排查重复,有疑似重复项时先展示。创建时用非交互方式 gh issue create --title "<title>" --body-file -,优先复用已有合适标签,不自动新建标签;正文按 Context、Observation、Why it matters、Evidence、Suggested follow-up 组织,尽量给出文件路径、函数名、命令与观察到的行为。若用户开启会话偏好,可在创建后导入 nytid:nytid todo import <owner/repo> --number <issue-number> --who dan-claude --here --github-labels,且 nytid 操作始终传 --who dan-claude,不修改分配给其他 worker 的条目。若返回输出无法可靠给出 issue 编号,先用 gh issue list 按标题精确解析再导入。

闭环:修复类 PR 或提交在正文用 Fixes #N(也可 Closes #N、Resolves #N)让 GitHub 在合并时自动关闭;仅部分解决或补充证据时用普通引用(#N 或 part of #N),保持 issue 打开;若发现已合并 PR 实现了某开放 issue 却未引用,可用 gh issue close N --comment "Implemented by PR #M ..." 手动关闭。沟通时说明拟定或已创建的标题、目标仓库、是创建在 GitHub 还是导入 nytid 或两者、是否因重复改为展示已有 issue;若未记录,说明原因。

限制:资料未提供该技能的收费、价格、适用平台与效果信息;不自动创建标签,不修改他人 todo,缺少 GitHub issue 能力时需用户明确要求才考虑 nytid 备选路径。