City-Lifeline-Cockpit/AGENTS.md

Codex 项目规则

编码规范

• 代码架构简单，逻辑清晰，每次生成代码量精简。保证人类可以较好的review。

验证命令

• 在修改本项目代码后，不要自动运行构建或调试命令。
• 这包括 npm run build、npm run dev、npm run serve、npm run preview、./package.json 的 scripts 中的命令、Vite 的 dev/preview 命令、本地服务器启动，以及基于浏览器的调试或截图。
• 只有当用户在当前对话中明确要求进行这些验证时，才可以运行这些命令。
• 允许进行只读检查，例如查看 diff 或源码文件。
• 在汇报已完成的工作时，需要说明：由于该项目规则要求，已跳过 build/debug 验证。

运行环境（所有会话共用）

• 前端服务地址：http://127.0.0.1:8000/#/cockpit —— 这是本驾驶舱前端唯一的开发/验收入口。所有会话在需要打开、引用或验收前端页面时，一律使用该地址，不要另起端口或另建服务。
• 后端接口地址：http://192.168.110.96:8301 —— 只读接口基址 http://192.168.110.96:8301/api/cockpit/v1/**，免鉴权。需要真实联调或复验时用它。
• 该地址只是约定，不构成启动授权：是否运行 dev server 仍按「验证命令」一节执行（未获用户明确要求不得启动）。
• 若地址变更，改这一节即可，不要在其它文档里另写第二份。

Agent skills

Project skills

skills/ at the repo root is this project's agent-skill root, discovered as Project Skills for this workspace. skills/tvt-js-plugin-builder/ is the TvT.js and plugin-workflow baseline: load /tvt-js-plugin-builder for plugin, case, preview-metadata, packaging, runtime-mode and integration work. See docs/agents/domain.md.

Issue tracker

Issues and specs live as local markdown under .scratch/<feature-slug>/. See docs/agents/issue-tracker.md.

Triage labels

Use the five canonical triage role strings unchanged. See docs/agents/triage-labels.md.

Domain docs

Use single-context domain docs, with openspec/specs/ and skills/tvt-js-plugin-builder/ as the TvT.js local spec and workflow baseline. See docs/agents/domain.md.