Git 提交:在用户明确要求提交时,轻量安全复核变更、精确暂存、运行相关验证并创建真实 Conventional Commit;只做本地提交,推送与对外发布由 507-release 承接。Use when user says commit, 提交, 提交一下, 提交这些改动, 提交代码, Git 提交, commit 一下, 生成并执行提交, 准备提交, 存个档。
对外发布:在用户明确要求发布、推送或发版时,定版本号、打 tag、推送远端,并按项目实际探测的发布渠道(npm、GitHub Release)发布。每个不可逆对外动作执行前都向用户显式确认。Use when user says release, publish, push, 发版, 发布, 推送, 发包, 打 tag, 升版本, 升级版本号, 发新版本, 上线, 发到 npm, 发 GitHub Release。默认只做用户明确点名的对外动作,不自动扩到全部渠道。
根因修复:已明确存在 bug、报错、崩溃、异常、回归或合并冲突时,先建立可重复反馈环,再以最小改动修复根因并验证。Use when user says fix, 修一下, 修 bug, 报错了, 崩了, 跑挂了, 有 bug, 修复报错, 合并冲突, 修复冲突, 修不通, debugging, error, crash, regression.
维护项目地图:以当前代码为证据,建立或校准 README、doc 组织、目录职责、入口与上下游,只修改地图文档。Use when user says map, project map, 梳理项目结构, 项目结构, 更新 README, 补 README, 校准 README, 整理 doc, 整理结构, 文档地图, 目录职责, 分层 README.
交付审查:围绕明确的 commit、branch、diff 或路径检查 Standards、Spec 与 Code Quality,只报告问题、证据和路由。Use when user says review this change, code review, review 一下, 检查, 审查, 审查改动, 审查这次改动, 检查提交, 检查分支, 过一遍代码, 把关, 需求符合度, 交付审查. 不用于主动寻找全库架构机会。
在保持公开契约与可观察行为不变的前提下,对指定代码范围或 507-inspect 报告逐项建立证据、修改并验证。可深入内部模块、抽象与接缝;若需要行为变化则停止并路由到需求实施。Use when user mentions simplify, simplify code, 简化, 简化代码, 行为不变重构, 内部简化, 按报告修改, 处理 inspect 报告, 局部重构, 降低复杂度, 收敛架构摩擦。
测试任务:测试本身是主要任务时,用现有框架补行为测试、运行测试、修正过时测试或缩小失败范围;真实生产 bug 转根因修复。Use when user says test, testing, 写测试, 加测试, 补测试, 跑测试, 运行测试, 测试挂了, 测试失败, 修失败测试, 缩小失败范围, coverage.
项目探索:面对尚未看清问题形状、无法安全规划或不知道从哪里开始的项目问题,先读取项目规则、既有共识与现实证据,在临时会话中区分已知、未知、当前 frontier 与证据边界;只读推进一个当前可解决问题,并路由到 explain、research、grill、prototype、规格或执行。Use when user mentions 探索一下, 先看看怎么回事, 先别做, 先理清, 梳理一下, 搞清楚状况, 摸清楚, 不知道从哪开始, 这个问题在哪, 帮我看懂这个项目, 上手这个项目, 这段代码怎么工作, explore, investigate this project, orient me, locate the problem, understand this codebase, explain this code.