Dillinger 中的 `/status` 命令：基于 Antigravity Kit 工作流的项目与 Agent 状态面板解析

前端开发工具【免费下载链接】dillingerThe last Markdown editor, ever.项目地址https://gitcode.com/gh_mirrors/di/dillinger点击查看免费下载导读/status是 Antigravity Kit本仓库.agent/目录内嵌的 AI Agent 能力扩展工具包提供的 11 个斜杠命令工作流之一用于在开发会话中一键汇总项目当前状态与多 Agent 任务进度。本文以 .agent/workflows/status.md 为核心完整解析该命令的输出结构、四大信息板块、示例格式与底层脚本依赖并结合仓库中的工作流与技能定义说明如何在实际项目如本仓库的 Dillinger Markdown 编辑器中理解、使用和扩展这一状态检查机制。一、/status在工作流体系中的定位本仓库的.agent/目录是一个完整的Antigravity Kit版本 5.0见 .agent/ARCHITECTURE.md由 16 个专业 Agent、40 个技能模块与 11 个斜杠命令工作流构成。/status正是这 11 个工作流之一其职责被定义为Show current project and agent status.即展示当前项目和 Agent 的实时状态。它与/preview预览管理、/enhance增量开发、/create新建应用等命令并列是会话中对进度与健康度进行快速巡检的入口。从.agent/workflows/目录结构看每个工作流都是一个独立的 Markdown 规范文件采用统一的 frontmatterdescription 命令定义 任务说明 示例输出 技术实现的骨架。/status文件同样遵循该结构因此它既是命令的行为规范也是实现该命令的需求文档。二、命令显示的四大部分核心内容/status的输出被划分为四个信息板块每个板块解决一个具体的状态查询问题板块回答的问题关键字段Project Info项目信息我在哪个项目工作项目名称、路径、技术栈、当前功能Agent Status BoardAgent 状态面板哪些 Agent 在跑、哪些任务完成了运行中 Agent、已完成任务、待办工作File Statistics文件统计这次开发改动了多少文件新建文件数、修改文件数Preview Status预览状态本地开发服务器还活着吗是否运行、URL、健康检查这四个板块对应一次协作开发会话中最常被追问的四类问题/status将它们压缩为一次命令调用即可全部获取。1. 项目信息Project Info项目名称与路径标识当前工作目录对应的项目例如本仓库的 Dillinger路径为仓库根目录技术栈Tech Stack框架、数据库、认证、支付等关键技术选型当前功能Current Features已实现的功能清单以及待办Pending功能。在 Antigravity Kit 的架构中这套信息来源于session_manager.py维护的会话状态。例如 .agent/workflows/enhance.md 第 2 步明确写道Load project state withsession_manager.py理解已有功能、技术栈说明session_manager.py是项目状态的权威持有者/status只是其status子命令的可视化出口。2. Agent 状态面板Agent Status BoardDillinger 仓库中的协作开发采用多 Agent 分工模式orchestrator、frontend-specialist、backend-specialist、database-architect、test-engineer等见 .agent/ARCHITECTURE.md。状态面板展示正在运行的 AgentRunning例如frontend-specialist正在构建 Dashboard 组件进度 60%已完成的任务/AgentCompleted例如database-architect、backend-specialist已交付待办工作Pending/Waiting例如test-engineer处于等待状态或 admin-panel、email-notifications 等功能尚未开始。这一板块让团队或人类开发者一眼看清谁在干活、谁干完了、还有啥没干避免重复劳动或任务遗漏。3. 文件统计File Statistics统计会话过程中对仓库文件的改动量新建文件数与修改文件数。在 .agent/workflows/enhance.md 的向用户呈现变更计划示例中可以看到这一指标的用途——Agent 在开工前会向用户预告将创建 15 个新文件、更新 8 个文件而/status则是在执行后对账验证实际改动与计划是否一致。4. 预览状态Preview Status服务器是否运行Is server running访问 URL例如http://localhost:3000健康检查Health check。该板块复用/preview工作流的运行时信息。根据 .agent/workflows/preview.md预览服务器由auto_preview.py脚本管理支持start/stop/restart/check子命令端口冲突时会交互式提供换端口 / 关闭占用应用 / 指定端口三个选项。/status通过调用auto_preview.py status获取服务器运行态与健康状态与/preview形成闭环/preview start启动服务/status随时确认服务健康。三、示例输出逐字段解析原文档给出了完整的示例输出这里逐字段展开说明 Project Status Project: my-ecommerce Path: C:/projects/my-ecommerce ️ Type: nextjs-ecommerce Status: active Tech Stack: Framework: next.js Database: postgresql Auth: clerk Payment: stripe ✅ Features (5): • product-listing • cart • checkout • user-auth • order-history ⏳ Pending (2): • admin-panel • email-notifications Files: 73 created, 12 modified Agent Status ✅ database-architect → Completed ✅ backend-specialist → Completed frontend-specialist → Dashboard components (60%) ⏳ test-engineer → Waiting Preview URL: http://localhost:3000 Health: OK字段要点Type项目模板类型如nextjs-ecommerce对应 Antigravity Kit 的 app-builder 模板体系nextjs-saas、nextjs-static、python-fastapi 等Status: active会话/项目生命周期状态Emoji 语义约定✅表示完成、表示进行中附带百分比进度、⏳表示等待/待办这是跨工作流统一的状态符号语言Files: 73 created, 12 modified文件统计区直接以数字对账开发产出Health: OK预览服务器的健康检查结果对应 .agent/skills/server-management/SKILL.md 中定义的HTTP 200 依赖可达 资源充足健康判定原则。四、技术实现与脚本依赖原文档的 Technical 部分明确给出/status的两个底层脚本调用session_manager.py status—— 负责汇总项目信息、Agent 状态面板、文件统计auto_preview.py status—— 负责预览服务器的运行状态与健康检查。这两个脚本属于运行时脚本原文档示例路径为~/.claude/scripts/即用户级 Agent 运行环境不在本仓库源码内因此这里只能依据文档描述说明其职责划分。需要强调的是两个脚本各自只负责自己领域的子命令/status工作流扮演的是聚合器角色——把两个独立脚本的输出组装为上文的分节报告。从本仓库可验证的运行时脚本规范看见 .agent/rules/GEMINI.md 的脚本清单Antigravity Kit 约定所有脚本以python path/script.py方式调用技能目录内的脚本如security_scan.py、playwright_runner.py均遵循python .agent/skills/skill/scripts/script.py的调用路径。/status对session_manager.py与auto_preview.py的调用遵循同一模式只是这两个脚本位于用户级~/.claude/scripts/而非项目内。五、与相邻工作流的协作关系/status不是孤立命令它与工作流体系内的其他命令存在明确的数据依赖与/preview的关系/status的 Preview 板块 auto_preview.py status的输出。因此开发流程通常是/preview start启动 →/enhance增量修改热重载或重启见 enhance.md 第 5 步→/status复核服务器健康与/enhance的关系/enhance开工前调用session_manager.py加载项目状态/status则是在开发中或开发后重新读取同一状态源两者读写同一份会话状态与/create的关系/create在完成应用构建后启动预览并将 URL 呈现给用户见 create.md/status正是后续会话中重新获取该 URL 与健康状态的入口。由此可以推断出/status在完整会话周期中的典型调用时机项目初始化后确认基线状态 → 多 Agent 并行开发中检查进度 → 每轮/enhance后核对文件改动量 → 交付前确认预览服务器健康。六、在 Dillinger 仓库中的落地视角本仓库主体是 Dillinger——一个基于 Next.js 的在线 Markdown 编辑器App Router 结构见app/目录编辑器核心见 components/editor/EditorContainer.tsx。若在这样一个真实项目中实践/status工作流四大部分的信息来源可对应到具体仓库内容Project Info技术栈为 Next.js TypeScript Tailwind CSS见 package.json核心功能包括 Markdown 编辑/预览、GitHub/Dropbox/Google Drive/OneDrive/Bitbucket 云同步见hooks/与app/api/各目录与 HTML/PDF/Markdown 导出见 lib/export.tsAgent Status Board对应.agent/agents/下的 16 个 Agent 文件例如 .agent/agents/backend-specialist.md 负责 API 与业务逻辑、test-engineer负责 Vitest 单测与 Playwright E2E测试实际散落于 tests/ 目录File Statistics可直接用git status与git diff --stat对账会话改动Preview Status对应本地开发服务器npm run dev的localhost:3000健康检查与本仓库的 Next.js 开发模式一致。这一视角说明/status命令规范是框架无关的其四大板块可以适配到任何具体仓库的目录与工具链上。七、状态面板的工程化要点结合 .agent/skills/server-management/SKILL.md 中学习思考而非背诵命令的原则/status的设计背后有以下可迁移的工程经验状态即接口用稳定的输出结构分节 固定字段 统一 emoji 语义承载易变的状态数据消费者人、Agent、自动化脚本都可以稳定解析职责分离session_manager管项目/任务状态auto_preview管服务器状态/status只做聚合展示——单一职责让两个脚本都可以被/enhance、/preview等命令独立复用健康检查纳入日常Preview 板块把服务器是否健康从偶发操作变成常态巡检项符合 server-management 中从第一天起就监控的告诫进度可视化Agent 状态面板用Completed / 百分比进度 / Waiting三态表达并行任务的推进情况为多 Agent 编排见 .agent/agents/orchestrator.md提供决策依据。结语/status是一个小命令、大设计的典型它以四个精炼板块覆盖了项目信息、多 Agent 进度、文件改动与预览健康四类高频查询底层依赖session_manager.py status与auto_preview.py status两个脚本完成职责分离的聚合。对于任何采用多 Agent 协作开发或希望建立会话级状态巡检习惯的团队本仓库 .agent/workflows/status.md 这份规范都可以作为直接参考模板——把输出结构、字段语义与脚本边界照搬到自己的 Agent 工作流体系中。赞分享前端开发工具【免费下载链接】dillingerThe last Markdown editor, ever.项目地址https://gitcode.com/gh_mirrors/di/dillinger点击查看免费下载相关推荐AG Kit /status 工作流详解基于 Antigravity 的项目与 Agent 状态汇报机制AG Kit /status 工作流详解基于 Antigravity 的项目与 Agent 状态汇报机制 /status 是 AG KitAntigravi人工智能AI 技能Dillinger 文档写作 Agent 全解面向人类与 LLM 的工程文档方法论与 Antigravity Kit 落地实践Dillinger 文档写作 Agent 全解面向人类与 LLM 的工程文档方法论与 Antigravity Kit 落地实践 本文以 Dillinger 仓前端开发工具用 Hugo 与 PaperMod 主题 3 步搭建个人博客并部署到 GitHub Pages用 Hugo 与 PaperMod 主题 3 步搭建个人博客并部署到 GitHub Pages 你刚把第一篇笔记写完想让它今晚就出现在自己的博客上。用 Hug前端上一篇Fritzing-Library部署指南在Windows、Mac和Linux上的完整安装教程下一篇electron-builder 修复 7-Zip Windows 架构缺陷7zip1.0.1 按架构分发 7za.exe 与校验和更新全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考