从大纲视图闪动抽搐问题中总结的编码经验教训，包括 CSS 自定义属性正确使用、Vue 响应式边界、DOM 操作与 CSS 变量选择等
Keeps MetaDoc UI locales in sync with zh_cn as the blueprint. Prefer running locales/i18n_keys.py (query/prefix/apply) instead of reading huge JSON. Use when fixing missing i18n keys, adding locale strings, or improving translation quality. Trigger: i18n, locales, i18n_keys, missing key, 翻译, 多语言, intlify Not found key.
MetaDoc 统一操作菜单规范。使用 ItemActionMenu 组件实现列表/卡片右键菜单或「...」按钮菜单，避免 shadcn DropdownMenu 与 el-dropdown 混用导致的 hover 缺失、双击触发、Dialog 内不显示等问题。使用场景：CardGrid、SessionList、配置/引擎/工具集管理界面等需要操作菜单的地方。
Manages AI/agent prompts in locale_prompts JSON and automates i18n (report missing keys, AI review/translate). Use when editing agent or tool prompts, adding locale_prompts keys, or running locale_prompts i18n scripts.
Integrates AI content generation with streaming output using createAiTask, StreamingContentDisplay, and centralized prompts. Use when adding or modifying features that call the LLM for content output, stream results in the UI, or manage prompt templates and i18n.
Run and test MetaDoc agent from the terminal via agent-cli (real tools, no mock). Use when testing agent tool CRUD (create/read/update/delete files and folders), debugging agent without GUI, or verifying the agent-cli TCP flow. Trigger: agent-cli, agent test, workspace CRUD, 工作区文件测试, agent 工具测试.
使用 GitHub CLI (`gh`) 管理 Issues、Pull Requests、Workflows、Repositories 等所有 GitHub 操作。支持自动化 TODO 扫描创建 Issues、PR 管理、CI/CD 监控等功能。
Standardizes creating and maintaining MetaDoc agent tools. Use when adding a new tool, changing tool spec/instruction/i18n, adding or updating a Display component, or aligning tool–Display message passing in meta-doc.