当需要基于已暂存的 git 变更或粘贴的 diff 生成 Conventional Commits 提交信息时使用。
当需要新增功能、端点、UI 流程、集成或数据模型变更,且涉及多文件影响或需求不清,需要范围规划时使用。
当处理缺陷、回归、失败测试、崩溃、错误输出、性能下降或不稳定行为(包括需要先补充复现或证据的情况)时使用。
通用迭代质量框架。默认适用于:多文件改动、复杂逻辑变更、质量敏感场景(核心功能/安全/用户体验),或需要确保完全满足明确成功标准的任务。
当需要评审代码、PR、diff 或补丁的正确性、安全性、性能或可维护性风险时使用。
当用户明确要求“核查/优化综述 `{主题}_review.tex` 的正文引用”或“运行 check-review-alignment”时使用。 通过宿主 AI 的语义理解逐条核查引用是否与文献内容吻合,**只在发现致命性引用错误时**对“包含引用的句子”做最小化改写,并复用 `systematic-literature-review` 的渲染脚本输出 PDF/Word(脚本不在本地直接调用 LLM API)。 核心原则:**不为了改而改**。无法确定是否为致命性错误时,保留原样并在报告中警告。 ⚠️ 以下情况不适用: - 用户只是想生成系统综述正文(应使用 systematic-literature-review) - 用户只是想新增/核对 BibTeX 条目(应使用专门的 bib 管理流程)
將 AI 生成的程式碼轉化為深度技術規格文檔,專注於解釋邏輯、定義介面、揭示潛在風險(N+1 查詢、Race Condition、記憶體洩漏)與設計決策。適用於 Bun + TypeScript 專案。觸發時機:(1) 開發完成後需要產出技術規格書 (2) 優化需求前需要分析架構缺陷 (3) 重構前需要梳理邏輯 (4) 使用者要求「分析架構」「生成技術文檔」「解釋設計決策」
系统化调试方法论。当用户遇到 Bug、代码错误、程序异常、需要排查问题时触发。提供三阶段调试法(精准定位→辅助排查→清洗代码)。即使不确定也要反问用户,不能卡住。
初始化项目上下文。两步流程:codex exec 生成基础框架 + AI 润色补充。触发词:初始化项目、init、初始化上下文。
为复杂任务创建详细实施计划。触发词:计划、规划、plan。
在任意 Git 仓库中,把当前电脑的工作区/本地分支强制对齐到远程 origin(把 origin 当唯一真源)。用于两台电脑来回切换开发、需要快速消除不同步/分支混乱时:自动备份本地状态(bundle+diff+可选未跟踪文件),然后 fetch --prune,删除远程不存在的本地分支,并将所有本地分支重置为对应的 origin/<branch>。
Project Organize