swain-status

用途：跨维度项目状态仪表盘。聚合 swain 工件生命周期、tk 任务跟踪、Git、GitHub issue 与会话状态，生成面向行动的视图。\n\n主要能力：从五个来源收集数据——工件（swain chart 的愿景层级、史诗进度、就绪/阻塞项与依赖）、任务（tk 进行中与近期完成）、Git（分支、工作区、近期提交）、GitHub（开放 issue、分配给用户的 issue）、会话（书签与上下文）。脚本终端输出使用 OSC 8 超链接。建议基于评分公式 score = unblock_count × vision_weight，权重继承自 Vision 祖先（high=3、medium=2、low=1、默认 medium）。\n\n用法：从项目根或已安装技能目录定位脚本并运行：\nSKILL_DIR="$(find . .claude .agents -path '/swain-status/scripts/swain-status.sh' -print -quit 2>/dev/null)"\nbash "$SKILL_DIR" --refresh\n若路径搜索失败，用 **/swain-status/scripts/swain-status.sh 通配。脚本运行后按 references/agent-summary-template.md 模板呈现摘要，先 Recommendation，再 Decisions Needed、Work Ready to Start，最后参考数据。紧凑模式：--compact 输出 4-5 行供 swain-stage 的 MOTD 面板使用：\nREPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"\nSTATUS_SCRIPT="$(find "$REPO_ROOT" -path '/swain-status/scripts/swain-status.sh' -print -quit 2>/dev/null)"\n[ -n "$STATUS_SCRIPT" ] && bash "$STATUS_SCRIPT" --compact || echo "swain-status.sh not found"\n缓存写入 .agents/status-cache.json，TTL 120 秒（可由 settings 的 status.cacheTTL 配置），--refresh 绕过 TTL，--json 输出原始缓存。\n\n限制与降级：chart.sh 不可用则跳过工件部分；tk 不可用则跳过任务部分；gh CLI 不可用或无 GitHub 远程则跳过 issue 部分；缺失 .agents/session.json 则跳过书签。不硬失败，仅展示可用数据。若 .agents/status-cache.json 不存在但 ~/.claude/projects/<项目路径标识>/memory/status-cache.json 存在，则读取旧位置一次并改为写入新位置。