SuperAPI AI 工具集

cmd-session-commit

写作与研究

查看项目

更新于 10-16 02:37

技能介绍

用途:分析当前编码会话,向 AGENTS.md 提出改进建议,并在获批后应用改动;当用户要求收尾、运行 session-commit 或记录最佳实践时使用。

主要能力:先读取现有 AGENTS.md 并梳理其章节结构;若仓库为指令文件记录了校验或修复命令,则在提议前运行;从会话中提炼可长期保留的经验。

可记录内容:会话中形成的编码模式与约定、应长期保留的架构决策与理由、调试手册与反复出现的坑、能改善后续会话的工作流偏好。

使用方式:按 references/change-proposal-format.md 的格式提出改动;在应用任何编辑前等待用户明确批准;获批后应用改动并与现有内容合并。若 CLAUDE.md、CODEX.md 或 GEMINI.md 缺失或为空,则创建指向 AGENTS.md 的符号链接。

限制与护栏:不记录会很快过时的临时实现细节;优先更新已有章节而非新建标题;使用简洁要点而非长段落;除非行为因工具而异,否则保持工具无关。若本次会话没有有意义的经验,应如实报告并停止。输出约定:提议阶段只输出拟议改动并给出 add/modify/remove 计数;应用阶段仅在明确批准后更新 AGENTS.md;完成阶段总结改动内容与位置。