SuperAPI AI 工具集

document

写作与研究

查看项目

更新于 10-15 23:42

技能介绍

用途:这是面向记录的写作技能,从真实变更历史生成人类可读文档,共四类:pr(面向评审者的 PR 标题与正文)、changelog(面向开发者的变更日志条目,追加到 CHANGELOG.md,遵循 Keep a Changelog)、release-note(面向终端用户的发行说明,写入 docs/releases/<version>.md 或聊天)、postmortem(面向团队的事后复盘,写入 docs/postmortems/<date>-<slug>.md)。

主要能力:每句话都可追溯到提交、差异或给定的事件事实,不发明时间线、原因或变更。类型可从上下文推断,否则最多问一个问题。事后复盘会向工程师索取 git 无法提供的事件事实。产物仅限 PR 文本、CHANGELOG.md、docs/releases/、docs/postmortems/。

使用方式:以 pr、changelog、release-note 或 postmortem 作为参数调用。收集历史使用以下命令,其余步骤用代理的跨平台文件工具完成:git rev-parse --verify main;git rev-parse --abbrev-ref HEAD;git log --oneline "BASE..HEAD";git diff --name-only "BASE...HEAD";git tag --sort=-creatordate。对 pr 做三项检查:gh 是否可用、仓库是否有远程、PR 是否已存在,据此决定是否执行 gh pr create 或 gh pr edit,否则仅在聊天中输出文本。release-note 若没有标签需询问版本名和范围。真正写入时在主线程读取 agent-prompt.md 与 templates/<type>.md,大差异可交给只读侦察子代理(haiku)摘要。

适用场景:需要为变更写 PR 说明、变更日志、发行说明或事后复盘时。

限制:不提交、不推送、不合并,只产出文字。命令仅依赖 git 与可选 gh,其他 shell 片段为 POSIX 参考,不假定 find、grep、sed、cat 等存在。没有交互选择器时以纯文本提问。不虚构任何未提供的事实。