菜单
Chat Gun React Agent 的前端、OpenSpec、Streaming Event、Tool Renderer、型別邊界、多模態流式鏈路與 React/Vite 編程約束。Use when working on frontend code, tool rendering, streaming contracts, multimodal requests/responses, Weather legacy refactors, or OpenSpec-driven changes in this repository.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MUST be considered at task start in this repository to detect OpenSpec change lifecycle work and route Claude Code/CCR coordination tasks without loading unnecessary context. Use for planning, proposal/design/tasks review, implementation handoff, result review coordination, readiness checks, archive decisions, and CCR/Codex/Qwen handoffs.
MUST be considered at task start in this repository to detect OpenSpec change lifecycle work and route it to token-efficient stage prompts. Use when the user asks Codex to plan, review, implement, fix, readiness-check, archive, or coordinate an OpenSpec change, especially with CCR/Qwen/Codex handoffs.
MUST be considered at task start in this repository to detect OpenSpec change lifecycle work and route Qwen Code review tasks without loading unnecessary context. Use for proposal, design, tasks, implementation-result, fix-result, readiness, archive, or CCR/Codex/Qwen handoff review.
對 OpenSpec、Git Diff、frontend、bff、backend、LangGraph、Tool、MCP 與安全邊界進行獨立唯讀審查，輸出 Blocker、Major、Minor 與標準 Verdict。
Apply when creating, modifying, refactoring, debugging, testing, or reviewing TypeScript, LangGraph JS, LangChain, provider adapter, tool, MCP, prompt, state, checkpoint, runtime event, or backend code under backend/** in chat-gun-react-agent.
| name | chat-gun-frontend-contract |
| description | Chat Gun React Agent 的前端、OpenSpec、Streaming Event、Tool Renderer、型別邊界、多模態流式鏈路與 React/Vite 編程約束。Use when working on frontend code, tool rendering, streaming contracts, multimodal requests/responses, Weather legacy refactors, or OpenSpec-driven changes in this repository. |
所有回覆、計畫、進度、錯誤說明與完成摘要一律使用繁體中文。技術名詞、API 名稱、套件名稱、函式名稱、CLI 命令與程式碼保留英文原文。
AGENTS.md、受影響套件的 AGENTS.md 與 openspec/config.yaml。| 任務類型 | 必讀文件 |
|---|---|
| OpenSpec Proposal、Specs、Design、Tasks、Verify、Archive | references/chat-gun-fe-openspec-workflow.md |
| LangGraph → BFF → Frontend 串流事件、SSE、Reducer、Terminal State | references/chat-gun-fe-streaming-event-contract.md |
| 歷史包袱、模組泛化、重構方案挑選、Weather 類案例 | references/chat-gun-fe-legacy-refactor.md |
| 深度思考、文字生成、視覺理解、圖片/影片/語音、多模態流式上下行 | references/chat-gun-fe-multimodal-streaming.md |
| Tool Result、ToolMessageDisplay、專項卡片、fallback 渲染 | references/chat-gun-fe-tool-renderer.md |
| frontend/bff/backend 型別邊界、泛型、runtime validation、schemaVersion | references/chat-gun-fe-type-boundary.md |
| React/Vite 元件、條件分支、Enum、i18n、環境變數、Bundle | references/chat-gun-fe-react-vite-conventions.md |
Record mapping。cd frontend
npm run lint
npm run test
npm run build
cd bff
npm run build
cd backend
npm run lint
npm run test
npm run build
只修改單一套件時，至少執行該套件全部既有驗證。跨層契約變更必須執行所有受影響套件的驗證。