用途:commit-staged 用于在用户要求“提交这些改动”“编写提交信息”“暂存并提交”“创建提交”“提交暂存文件”时,按项目规范完成提交流程。
主要能力:先对暂存的差异运行 /simplify 技能并应用其结果(仅文档的差异为空操作)。提交信息采用约定式格式:首行 {type}: 简要描述(不超过 50 字符),类型包括 feat、fix、refactor、docs、style、test、build。优先说明“为什么”而非“做了什么”,可使用会话历史中的发现与动因,复杂改动可在空行后加要点。还会检查 README.md 是否需要更新新功能、过时描述或缺失的依赖安装说明。
使用方式:若可用子代理,使用 github-dev:commit-creator 执行完整流程,并传入额外调用文本作为上下文;否则手动执行:用 git diff --cached --name-only 查看暂存文件,用 git diff --cached 阅读差异,完全忽略未暂存改动。提交使用 HEREDOC 语法,并校验信息格式。调用时附带的额外文本会作为改动上下文纳入提交规划与信息。
限制与注意:只分析暂存文件,不处理未暂存改动;提交信息不添加测试计划;一次提交一个逻辑变更;首行不超过 50 字符,使用主动语态与简洁准确的措辞,避免术语和仓库缩写(除非需要精确命令或工具名)。关于具体错误处理、依赖版本或平台兼容性等细节,资料暂未提供。