用途:openspeccer 是面向任何包含 openspec/ 目录仓库的只读本地 Web 仪表板,用于回答“有哪些变更在进行中”或查看某个变更的进度。
主要能力:脚本可从给定仓库路径查找 openspec/,或省略路径时从当前目录向上搜索。--summary 输出状态摘要,--change <slug> 查看单个变更的产物与任务,--json 打印完整快照。仪表板页面会随文件变化自动更新,编辑产物后无需手动刷新。默认聚合所有 git worktree 中的活跃变更。
使用方式:运行 <this-skill-dir>/scripts/serve.py --help 查看全部选项;状态查询运行 serve.py <repo> --summary 或 --change <slug>;启动仪表板时以后台进程运行 serve.py <repo>,等待出现包含 serving <name> at <url> 的行后,将 URL 提供给用户。无头或远程会话、或对已运行的服务器重复执行时加 --no-open。停止时用启动时捕获的 PID 或任务句柄结束该后台进程。
限制与注意:重复对同一仓库运行会复用已运行服务器并提示 already serving。非本会话启动的服务器属于用户,应保持运行。OpenSpec CLI 可选,仅影响 Schemas 和 Commands 页面;缺少时仅显示项目 schemas,Commands 为空。CLI 不在 PATH 时可设 OPENSPECCER_OPENSPEC_BIN。