用途:刷新并展示项目路线图与状态仪表板,作为 swain-design 的 chart.sh roadmap 的用户入口,从制品图谱重新生成 ROADMAP.md 并打开。
主要能力:项目级 ROADMAP.md 包含优先级矩阵象限图(PNG,mmdc 不可用时回退为内联 Mermaid)、按象限分组并带短 ID 的图例、含进度/解除阻塞数/待决策的艾森豪威尔表(Do First/Schedule/In Progress/Backlog)、带依赖链接的甘特时间线,以及存在依赖时的阻塞关系图。每个 Vision 与 Initiative 还会生成 roadmap.md 切片,含意图摘要、子制品表、聚合进度条、近期提交与优先级子集。状态仪表板支持完整、--compact 紧凑(MOTD)、--json 原始输出与 --refresh 绕过缓存。
使用方式:先检查会话是否 active(bash "$REPO_ROOT/.agents/bin/swain-session-check.sh");定位 CHART_SH="$REPO_ROOT/.agents/bin/chart.sh",找不到则说明未安装 swain-design 并停止。带制品 ID(如 VISION-001)时执行 bash "$CHART_SH" roadmap --scope "$SCOPE_ID",否则执行 bash "$CHART_SH" roadmap 生成根目录 ROADMAP.md 及各切片。生成后扫描并替换 {{INTENT: <ID>}} 占位符(取 Value Proposition 或 Goal/Objective 首句,找不到则保留)。随后打开对应渲染文件,并用 bash "$CHART_SH" roadmap --cli 输出终端可读摘要。列出条目时可用 artifact-context.sh 提供上下文行,否则回退为 ID 加标题;若 .agents/session.json 设定了 focus lane,结尾用 swain-focus.sh 提示。说 status、what's next、dashboard 等时运行 swain-status.sh --refresh,缓存写入 .agents/status-cache.json,TTL 120 秒,推荐取 .priority.recommendations[0]。
限制:本技能始终无条件重新生成,属强制刷新路径;终端无法渲染表格与 Mermaid,需用 --cli。chart.sh 失败时显示错误并建议运行 swain-doctor;若只有旧的 ROADMAP.md 则显示并附过期警告,不硬失败。其余细节暂未提供。