peiiii / qingtian-dashboard
当用户要求打开、启动或查看擎天大盘、当前项目的 AI 开发体系大盘或跨项目产物大盘时使用;仅讨论大盘设计、修改业务页面或询问体系接入不触发启动。
0
SKILL.md2.9 KB
打开擎天大盘
完成结果是当前项目可用的大盘及用户能打开的地址,也可切换其它已接入项目。直接执行已授权的启动请求;不要只返回命令让用户再操作,也不要为查看大盘进入完整开发流程。
- 在当前项目目录检查
node --version和qingtian --version。已有可用命令直接使用;缺少命令且 Node.js >=22.12 时执行官方安装npm install -g @nextclaw/qingtian --ignore-scripts --registry=https://registry.npmjs.org,再核验版本。Node 版本不足、离线或 npm 权限失败时报告具体缺口,不用 sudo、改权限或猜包名;可用npx --yes --package=@nextclaw/qingtian qingtian dashboard避免全局写入失败,但不能解决不支持的 Node 或断网。 - 若当前会话已有大盘完整地址、服务仍可用且显示当前项目,可复用并重新读取;否则从当前项目目录运行
qingtian dashboard。默认优先识别当前项目(含从子目录启动),首页展示它的推进、关注与产物;其它接入项目可在侧栏切换。仅用户指定扫描范围时用--root <绝对目录>;可重复指定。当前项目位于其它位置、需要长期加入时用qingtian projects add <绝对目录>。 - 保持服务运行:使用宿主提供的持久终端/执行会话;不要在普通会被销毁的短进程里启动后立即退出。CLI 默认自动打开浏览器;宿主需要自己展示页面时可用
--no-open,取得实际输出的完整 URL 后用宿主的打开浏览器/文件面板工具打开。没有可用页面工具时给用户完整可点击地址。不要猜固定端口或复用已过期的会话凭据。 - 验证真实可用性:查看页面已加载当前项目/产物或明确的空态;无法看页面时用输出 URL 的 fragment 中 token 作为 Bearer 凭据读取同一地址的
/api/snapshot,要求 HTTP 200 和有效项目列表,并核对currentProjectId对应当前项目。若当前目录尚未接入、或用户指定扫描范围不包含当前项目,明确说明总览需要选择项目;不擅自接入项目。仅进程启动或静态首页 HTTP 200 不足以说明数据可读。输出项目数只是此次快照,不表示所有项目完成。
返回大盘已打开/已启动、实际入口和停止方式(对应终端 Ctrl+C)。说明当前项目不在列表、扫描警告或宿主无浏览器等真实边界;已成功的启动不重装 CLI、不重启其它任务的服务。
完整 URL 的 token 只供当前用户本机使用;不提交到项目文档或外发。大盘只读文档,不承担自动执行、任务状态修改或云端部署。