用途
这是一个只读的状态汇报技能,用于在恢复暂停的会话或加入团队时,快速了解当前进展。它扮演的角色是给归队的队友做一次直接的“我们目前在哪里”的简报。它只读取持久化的信号,不依赖对上次会话的记忆,也不触碰实际工作,只负责为即将接手的人指明方向。
主要能力
该技能从 Git 仓库和持久化文档中收集信息并汇报:
- Git 状态:当前分支、未提交/已暂存/未跟踪的改动、与远程的领先/落后提交数、最近提交记录。
- 路线图进度:按状态统计功能(planned/in-progress/done),以及 existing(预先存在)和 dropped(已取消)的功能;对进行中的功能列出子任务完成情况和第一个未勾选的任务(恢复点)。
- 决策:列出架构决策记录(ADR)及其状态(Proposed/In Progress/Accepted/Superseded)。
- 协作风险:如落后于远程、存在未提交工作、进行中功能与其他作者重叠、ADR 与功能状态不一致、已取消功能仍关联 ADR、分离头指针等。
- 计划与现实的偏差:未纳入计划的代码、孤立 ADR、标记为完成但近期有大量改动的功能。
- 建议的下一步:给出单条最合理的后续命令。
使用方式
运行 /status 即可。该技能只读取和汇报,不写入任何内容、不修改任何文件、不运行构建,可在任何时候安全执行,包括工作区不干净或任务进行中。它不询问任何问题,只告诉你当前所处的位置。
执行步骤包括:
- 收集 Git 状态(分支、改动、与远程的差异、最近提交)。
- 扫描路线图文件(默认
docs/roadmap/,若docs/是已发布的文档站点则用.workflow/roadmap/),解析功能状态、子任务和构建方式。 - 列出 ADR 及其状态。
- 检查协作与会话风险。
- 交叉核对计划与现实,发现偏差。
- 输出报告。
适用场景
- 恢复暂停的会话,需要知道从哪里继续。
- 加入团队或接手他人工作时,快速了解仓库和路线图状态。
- 在开始新工作前,确认是否存在未提交改动、远程更新或协作冲突。
- 定期检查计划与代码、ADR 之间是否出现偏差。
限制
- 只读,不执行任何修改或构建。
- 仅依赖 Git 和代理的文件工具,
git是唯一必需的命令行工具。 - 产物路径默认为
docs/,若docs/是已发布的文档站点则使用.workflow/。 - 若没有路线图,会提示使用
/roadmap(全新项目)或/audit(已有项目)来建立。 - 若路线图文件格式异常,会标记出来而不是静默误报。
- 不拥有任何产物,仅输出聊天内容。
- 输出风格要求使用平实简单的语言,不使用任何破折号(em dash、en dash 或作为标点的连字符),用短句、逗号或括号代替。