@mison/ag-kit-cn 3.0.0-beta.0 → 3.0.0

package/docs/official/codex/rules.md

@@ -1,79 +0,0 @@
-# 规则（命令审批规则）
-
-> 来源：`https://developers.openai.com/codex/rules`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-Codex Rules 用于控制“哪些命令允许在沙箱外执行”，属于安全与审批策略层。  
-该能力为实验特性，后续可能调整。
-
-## 创建规则文件
-
-1. 在 `./codex/rules/` 下创建 `.rules` 文件（例如 `~/.codex/rules/default.rules`）。
-2. 写入规则。
-
-示例：在沙箱外执行 `gh pr view` 前必须提示审批。
-
-```python
-prefix_rule(
-    pattern = ["gh", "pr", "view"],
-    decision = "prompt",
-    justification = "查看 PR 需要人工确认",
-    match = [
-        "gh pr view 7888",
-        "gh pr view --repo openai/codex",
-    ],
-    not_match = [
-        "gh pr list",
-    ],
-)
-```
-
-## 规则字段说明
-
-`prefix_rule(...)` 常用字段：
-
-- `pattern`：命令前缀（按 token 匹配）
-- `decision`：命中后的动作
-- `justification`：规则说明（可选）
-- `match`：应命中的测试样例（可选）
-- `not_match`：不应命中的测试样例（可选）
-
-`decision` 常见值：
-
-- `prompt`：询问用户
-- `allow`：允许
-- `deny`：拒绝
-
-## 关于 shell 包装命令与复合命令
-
-常见包装命令包括：
-
-- `bash -lc "..."`
-- `sh -c "..."`
-- `zsh -lc "..."`
-- `python -c "..."`
-
-在可安全拆分时，Codex 可能提取出真实命令做前缀匹配；  
-在不可安全拆分时，会把整体当作一个命令匹配。
-
-### 可安全拆分的典型情况
-
-- 单一命令、无复杂重定向/管道/变量展开
-- 命令结构明确，不会因拆分改变语义
-
-### 不拆分的典型情况
-
-- 包含复杂 shell 语法（多条命令、重定向、条件、子 shell 等）
-- 拆分后可能造成语义偏差或安全风险
-
-## 测试规则文件
-
-建议每条规则都写 `match` / `not_match` 示例，作为“内联单元测试”。  
-这样可以在维护规则时快速验证匹配行为，减少误放行或误阻断。
-
-## 规则语言边界
-
-- Rules 只负责命令级审批策略，不负责业务逻辑说明。
-- 业务约束建议放在 `AGENTS.md` 或项目文档中。
-- 高风险命令建议默认 `prompt` 或 `deny`，再按需要放开。

package/docs/official/codex/skills.md

@@ -1,114 +0,0 @@
-# Agent 技能（Codex）
-
-> 来源：`https://developers.openai.com/codex/skills`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-Skills 用于给 Codex 增加任务专用能力。  
-一个 Skill 通常打包了指令、参考资料以及可选脚本，便于 Agent 稳定复用某类流程。
-
-Skills 适用于 Codex CLI、IDE 扩展和 Codex App。
-
-## Skill 基本结构
-
-一个 Skill 目录至少包含 `SKILL.md`：
-
-```text
-my-skill/
-├── SKILL.md        # 必需：元信息 + 指令
-├── scripts/        # 可选：可执行脚本
-├── references/     # 可选：参考文档
-└── assets/         # 可选：模板/资源
-```
-
-`SKILL.md` 需包含 `name` 与 `description`：
-
-```markdown
----
-name: skill-name
-description: 说明该 skill 的用途与触发场景
-metadata:
-  short-description: 可选的简短说明
----
-
-# Skill 标题
-
-在此编写可执行指令。
-```
-
-## Codex 如何使用 Skills
-
-Codex 采用“渐进式加载”：
-
-1. 会话开始时先读取各 Skill 的元信息（`name`、`description`、路径等）。
-2. 仅当某 Skill 与当前任务相关时，才读取完整 `SKILL.md`。
-3. 执行过程中按 Skill 指令调用脚本/引用资料。
-
-## 创建 Skill
-
-两种方式：
-
-- 使用内置 Skill（例如 `$skill-creator`）辅助生成
-- 手动创建目录与 `SKILL.md`
-
-手动创建建议流程：
-
-1. 创建目录 `my-skill/`
-2. 写好 `SKILL.md` 的 frontmatter
-3. 按需补充 `scripts/`、`references/`、`assets/`
-
-## Skill 存放位置
-
-常见位置：
-
-- 全局：`$HOME/.agents/skills/`
-- 项目：从当前工作目录开始，向上到仓库根目录，按链路扫描 `.agents/skills/`
-
-实践建议：
-
-- 跨项目复用放全局
-- 项目专属流程放仓库内并随代码版本管理
-
-## 安装与管理
-
-可通过 CLI 管理技能开关与列表（实际命令以当前版本为准）：
-
-```bash
-codex skills list
-codex skills enable <skill-name>
-codex skills disable <skill-name>
-```
-
-对于 App/Server 场景，也可通过 API 传入 Skill 项。
-
-## 可选元数据
-
-除必填字段外，可在 frontmatter 增加元数据（如 `short-description`），用于改善 UI 展示和匹配体验。  
-但不要把业务逻辑藏在元数据里，核心行为应写在正文指令区。
-
-## 编写最佳实践
-
-### 1. 描述要能触发
-
-`description` 建议写清：
-
-- 做什么
-- 何时用
-- 不适用场景
-
-### 2. 单一职责
-
-一个 Skill 解决一类问题，不要做“万能包”。
-
-### 3. 脚本优先可执行
-
-把复杂流程写进 `scripts/`，在 `SKILL.md` 中说明参数与调用方式。  
-避免要求 Agent 反复阅读大段脚本源码。
-
-### 4. 给出决策分支
-
-复杂任务建议提供“条件 -> 路径”决策表，降低误用率。
-
-### 5. 保持可迁移
-
-尽量避免绑定私有路径与私有环境变量，必要时在 `references/` 说明依赖前置条件。

package/docs/official/mechanism-compat-audit-2026-03-04.md

@@ -1,36 +0,0 @@
-# 体系兼容审查（2026-03-04）
-
-## 审查范围
-
-- `skills / agents / workflows / rules / mcp` 机制一致性与可执行性
-- 对照官方来源：
-  - Antigravity 资产文档
-  - Codex 官方文档（含 `skills/rules/agents-md/mcp/workflows/security`）
-  - Gemini CLI 官方仓库文档（含 `skills/plan-mode/subagents/mcp-server/policy-engine/gemini-md`）
-
-## 结论（摘要）
-
-1. 本仓库当前机制可用，核心流程与官方规则方向兼容。
-2. 先前存在的关键一致性问题已修复（见下节），回归测试通过。
-3. 仍存在“产品策略差异”而非 bug：本仓库 `gemini` 目标采用 `.agent` 结构，不是 Gemini CLI 原生 `.gemini` 目录体系，属于兼容层设计取舍。
-
-## 本次已修复项
-
-1. Codex 完整性检查漏报：`manifest.json` 非法 JSON 现在会标记为 `broken`。
-2. Gemini 完整性检查过宽：空 `.agent` 不再判定 `ok`，会校验关键目录与文件。
-3. 规则路径错误：`GEMINI.md` 中设计 Agent 路径改为 `.agent/agents/...`。
-4. Agent 引用失配：移除不存在的 `api-designer` 引用，能力并入 `backend-specialist` 描述。
-5. Skill 交叉引用失效：替换不存在的 skill 引用为仓库内实际存在的 skill。
-6. workflow 引用失效：`conversation-manager` 改为现有 `brainstorming`。
-7. MCP 示例安全性：`context7` 官方通道改为环境变量注入 API Key，并新增 `context7_backup` 备用通道。
-8. 官方证据索引更新：Gemini CLI 仓库最新推送时间更新至 `2026-03-04T02:20:00Z`。
-
-## 当前建议关注
-
-1. 若目标是“与 Gemini CLI 原生机制完全同构”，需要单独规划 `.gemini` 目录与策略引擎对齐方案。
-2. `context7_backup` 可用性建议后续做一次端到端联通性验证（网络/无 key/服务异常场景）。
-
-## 验证结果
-
-- `bun run test`：`63/63` 通过。
-- `bun run health-check`：通过。

package/docs/official/rules-baseline.md

@@ -1,67 +0,0 @@
-# 官方规则基线（2026-03-04）
-
-> 本文只记录官方约定，不引入本仓库私有机制。证据见 `docs/official/sources-index.md`。
-
-## Antigravity
-
-官方文档：
-
-- Skills：`/agent/skills.md`
-- Rules / Workflows：`/agent/rules-workflows.md`
-- Agent Modes / Settings：`/agent/agent-modes-settings.md`
-- Strict Mode：`/agent/strict-mode.md`
-- Sandboxing：`/agent/sandbox-mode.md`
-- MCP：`/tools/mcp.md`
-
-规则要点（按官方语义）：
-
-1. Skills 以 `SKILL.md` 为核心，依赖描述触发并按需加载完整内容。
-2. Rules 与 Workflows 是两套机制：规则用于行为约束，工作流用于步骤化执行。
-3. Strict Mode 与 Sandboxing 分别约束访问边界和命令执行能力，可叠加使用。
-4. MCP 通过 MCP Store / 配置入口接入外部能力，不等价于本地脚本直接执行。
-
-## Codex
-
-官方文档：
-
-- Skills：`/codex/skills.md`
-- Rules：`/codex/rules.md`
-- AGENTS.md：`/codex/guides/agents-md.md`
-- MCP：`/codex/mcp.md`
-- Workflows：`/codex/workflows.md`
-- Security：`/codex/security.md`
-
-规则要点（按官方语义）：
-
-1. Skills 约定 `name`、`description` 元信息，支持启停和目录扫描。
-2. Rules 是命令审批规则体系（`.rules` / `prefix_rule` / 校验命令），用于控制高风险命令。
-3. `AGENTS.md` 是项目级指令入口，支持分层发现与覆盖。
-4. MCP 在 `config.toml` 配置，支持 stdio / streamable HTTP / OAuth 等模式。
-5. Workflows 文档描述的是推荐用法范式，不等同于 Antigravity 的自定义 workflow 注册机制。
-6. Security 定义审批策略、沙箱模式和网络访问边界。
-
-## Gemini CLI
-
-官方文档（仓库 `google-gemini/gemini-cli`）：
-
-- `docs/cli/skills.md`
-- `docs/cli/gemini-md.md`
-- `docs/cli/plan-mode.md`
-- `docs/core/subagents.md`
-- `docs/core/remote-agents.md`
-- `docs/tools/mcp-server.md`
-- `docs/reference/policy-engine.md`
-
-规则要点（按官方语义）：
-
-1. Skills 支持发现、安装、启用/禁用与作用域管理（user/workspace）。
-2. `gemini.md` 用于项目指令与上下文约束。
-3. Plan Mode 是受限规划模式，可配合策略规则开放只读工具。
-4. Subagents / Remote Agents 提供多代理协作能力，受实验特性与配置开关约束。
-5. MCP Server 与 Policy Engine 联合定义工具接入和审批策略。
-
-## 使用建议
-
-1. 先看官方规则，再决定本仓库是否需要兼容层改动。
-2. 文档更新先改 `sources-index.md`，再更新本文件的规则要点。
-3. 若官方文档术语有歧义，保留英文术语并附中文解释，避免语义漂移。

package/docs/official/sources-index.md

@@ -1,79 +0,0 @@
-# 官方来源证据索引
-
-> 用途：为 `docs/official` 提供可复核的证据层（来源 URL + 时间 + SHA/提交记录）。
-
-## 历史本地快照（2026-02-12 UTC）
-
-> 说明：以下为此前本地中文整理稿的归档记录，保留用于追溯。
-
-### Antigravity
-
-| 本地文件 | 来源 URL | 拉取时间 (UTC) | SHA256 |
-| --- | --- | --- | --- |
-| `docs/official/antigravity/agent-modes-settings.md` | `https://antigravity.google/assets/docs/agent/agent-modes-settings.md` | `2026-02-12T12:56:22Z` | `614174f8c730a0db8b290dede16b294a9535cef7b9ddca9c108dc2ef583b2919` |
-| `docs/official/antigravity/rules-workflows.md` | `https://antigravity.google/assets/docs/agent/rules-workflows.md` | `2026-02-12T12:56:22Z` | `063b2e9c86555f0103d0fafee5f71caf330cd95fb25257841efe32d36ee9667b` |
-| `docs/official/antigravity/skills.md` | `https://antigravity.google/assets/docs/agent/skills.md` | `2026-02-12T12:56:22Z` | `2176fc1968c2188daed75b064f8771e4516b4b462cc5c1b98553e05cfab055fa` |
-
-### Codex
-
-| 本地文件 | 来源 URL | 拉取时间 (UTC) | SHA256 |
-| --- | --- | --- | --- |
-| `docs/official/codex/config-basic.md` | `https://developers.openai.com/codex/config-basic.md` | `2026-02-12T12:56:22Z` | `9a270e83da4e3467c117166cc69684cace72037c97c96f0f05f212d28ccf0809` |
-| `docs/official/codex/config-advanced.md` | `https://developers.openai.com/codex/config-advanced.md` | `2026-02-12T12:56:22Z` | `ed1ebb5ad918fd9043ebeb176d1f29654d76547c4ae896eb4718db320f98a1af` |
-| `docs/official/codex/config-reference.md` | `https://developers.openai.com/codex/config-reference.md` | `2026-02-12T12:56:22Z` | `e23bc1439e3f4cb907d165e6980ece03070d69484f74c4cb3dd95068c519a91c` |
-| `docs/official/codex/config-sample.md` | `https://developers.openai.com/codex/config-sample.md` | `2026-02-12T12:56:22Z` | `80af7755383b5f3956b3288435bca81ef02062f6dd988aa6205fe1ae95a3660b` |
-| `docs/official/codex/rules.md` | `https://developers.openai.com/codex/rules.md` | `2026-02-12T12:56:22Z` | `c9ca3c8bf4fa68ccf85c831388ea360b6e2108bcfcfcc0b7bd7e2ab5df173af1` |
-| `docs/official/codex/agents-md.md` | `https://developers.openai.com/codex/guides/agents-md.md` | `2026-02-12T12:56:22Z` | `ed8fd0bdb19826d907424d313d38b37fe9a60c78b96692f409e1f15373817aac` |
-| `docs/official/codex/mcp.md` | `https://developers.openai.com/codex/mcp.md` | `2026-02-12T12:56:22Z` | `bb7d0e864ed572a11067505f9cd673972610d2d53997db3647b309da00763fa2` |
-| `docs/official/codex/skills.md` | `https://developers.openai.com/codex/skills.md` | `2026-02-12T12:56:22Z` | `8ca8093fa07e50d302a76a6693789995bb733208fd3e89022e2ebd2328b3b64c` |
-
-## 在线核验结果（2026-03-04 UTC）
-
-> 说明：本节记录官方线上文档当前内容哈希。该哈希对应“远端当前内容”，用于判断更新，不等于本地整理稿哈希。
-
-### Antigravity（规则类）
-
-| 官方 URL | 当前 SHA256 | Last-Modified |
-| --- | --- | --- |
-| `https://antigravity.google/assets/docs/agent/skills.md` | `0e22e88bb316540d5db941e1c794f7a498536dead8f563e5da41d9530ede3b03` | `N/A` |
-| `https://antigravity.google/assets/docs/agent/rules-workflows.md` | `738e8982afda84f8ec75940472e225994ff65ed872296d31fb07c26888d447fd` | `N/A` |
-| `https://antigravity.google/assets/docs/agent/agent-modes-settings.md` | `cfa1662105b8401c77fdfa617ad264f40827573377958db1f14b22c5d99fb78c` | `N/A` |
-| `https://antigravity.google/assets/docs/agent/strict-mode.md` | `fefb2693dfdfdf641d37261e5e46f5e77090c8d4ad227f17d5b93bdc9e6e3ca7` | `N/A` |
-| `https://antigravity.google/assets/docs/agent/sandbox-mode.md` | `24ba64c5f270bd889654f660eb26d460a39ef95a366616a745bff756000f2863` | `N/A` |
-| `https://antigravity.google/assets/docs/tools/mcp.md` | `f2111a68a10bc8de059538faa9f7409ed71c17b3256176e0828b476fd71b03fd` | `N/A` |
-
-### Codex（规则类）
-
-| 官方 URL | 当前 SHA256 | Last-Modified |
-| --- | --- | --- |
-| `https://developers.openai.com/codex/skills.md` | `84f3062af1e105e62d926ec5156301c6058072961b800b1d9d5936f13dbbb260` | `Wed, 04 Mar 2026 01:27:34 GMT` |
-| `https://developers.openai.com/codex/rules.md` | `31d5ee04c58d6fc31389c9188cbeebc44a5c1fc74ce4ddce7c9a692b8d86de36` | `Wed, 04 Mar 2026 01:27:35 GMT` |
-| `https://developers.openai.com/codex/guides/agents-md.md` | `783657b995e1245d38e71854cd563d52021db2ddd3502b619a6a2a10785953fe` | `Wed, 04 Mar 2026 01:27:37 GMT` |
-| `https://developers.openai.com/codex/mcp.md` | `e46307e000c9f9b49560b69c866245ae8886ace76b12cc0cca71985a055fb65a` | `Wed, 04 Mar 2026 01:27:36 GMT` |
-| `https://developers.openai.com/codex/workflows.md` | `9ddeeaf1caecd91f225a94eb0dcea6c830da997b20c44da063abfd39cdf7dbc1` | `Wed, 04 Mar 2026 01:27:38 GMT` |
-| `https://developers.openai.com/codex/security.md` | `0f438953c912d4b17b124d9be3c1c32c22927a9a97cc15d46b32acd70da01e52` | `Wed, 04 Mar 2026 01:27:39 GMT` |
-
-### Gemini CLI（规则类）
-
-| 文档路径（仓库） | Raw URL | 当前 SHA256 | 最近提交 (SHA) | 提交时间 (UTC) |
-| --- | --- | --- | --- | --- |
-| `docs/cli/skills.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/skills.md` | `1c20e188cbf39efa93d0fd4f48f1dc605c9f156c62bfc725206f60cee82fcc01` | `d1ca8c0c80b4` | `2026-02-16T04:18:36Z` |
-| `docs/cli/creating-skills.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/creating-skills.md` | `f234e2ff0f1e8f49580137a99abf4fbcd8299afcf349e0710743fde1b35ed1e5` | `d43d772e657b` | `2026-01-29T23:52:06Z` |
-| `docs/cli/plan-mode.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/plan-mode.md` | `da18320390139d08efe28c4c7431047ad2a0860df93bfc8668d7b1d5ae2f1344` | `b5f3eb2c9c61` | `2026-03-03T21:36:51Z` |
-| `docs/core/subagents.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/core/subagents.md` | `b1345de3c156d7c59e047b66e96bd2653bf364e32e9e3b706d2ebe87c78e73d6` | `9e95b8b3c53d` | `2026-02-24T17:22:09Z` |
-| `docs/core/remote-agents.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/core/remote-agents.md` | `a5b6e6ad1ef617a8c5c5d8835e2808714fa85bcd4d0589d46b7197fa31ec2505` | `3103697ea73e` | `2026-01-27T22:15:28Z` |
-| `docs/tools/mcp-server.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/tools/mcp-server.md` | `e96e899d818d2e72b3f296ad8d5ea2544497d2ab90de2c42c0280a2950858ce2` | `20d884da2fe1` | `2026-02-27T20:04:36Z` |
-| `docs/reference/policy-engine.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/reference/policy-engine.md` | `abf7f48de1d77c1619d7add259f8788f9ca142824adaab003abb7fa7f1af3643` | `c89d4f9c6c97` | `2026-02-27T23:41:47Z` |
-| `docs/cli/gemini-md.md` | `https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/cli/gemini-md.md` | `d1ccf1120ae69e90f4becabe11342b4c857b4e8fc2807219dab96ef923ee338e` | `d25c469f7723` | `2026-02-19T23:47:39Z` |
-
-Gemini CLI 仓库最新推送时间：`2026-03-04T02:20:00Z`
-
-## 校验命令示例
-
-```bash
-curl -fsSL --compressed https://developers.openai.com/codex/skills.md | shasum -a 256
-```
-
-```bash
-gh api "repos/google-gemini/gemini-cli/commits?path=docs/cli/plan-mode.md&per_page=1"
-```

package/docs/operations.md

@@ -1,75 +0,0 @@
-# Ag-Kit（命令行工具）运维手册
-
-本文面向维护 Ag-Kit 及其托管资源的 DevOps 与高级用户，基线为 v3 统一目录体系。
-
-## 1. 目录结构
-
-```text
-/my-project
-├── .agents/              # Canonical（唯一主目录）
-│   ├── manifest.json     # 完整性清单（v3）
-│   ├── skills/ agents/ workflows/ rules/
-│   ├── AGENTS.md         # 托管区块源
-│   ├── antigravity.rules # 托管区块源
-│   └── mcp_config.json   # MCP（含 Context7 主备）
-├── .agent/               # Antigravity 兼容投影（自动生成）
-├── .gemini/              # Gemini 兼容投影（自动生成/合并）
-├── .agents-backup/       # 覆盖前自动备份
-├── AGENTS.md             # 根入口（保留用户内容 + 托管区块）
-└── antigravity.rules     # 根托管说明（保留用户内容 + 托管区块）
-```
-
-### Legacy 目录策略
-- `.codex`：仅在识别为本工具托管 legacy 时迁移/清理。
-- 非托管 `.codex`：保留不删除。
-
-## 2. 核心运维动作
-
-### 2.1 初始化/升级
-```bash
-ag-kit init
-ag-kit update
-```
-
-- `--target gemini|codex` 仍兼容，但内部归一为 full。
-- 非交互默认 full；遇到 `.agent` / `.gemini/agents` 冲突时，交互询问处理策略。
-
-### 2.2 批量更新
-```bash
-ag-kit update-all --targets full
-```
-
-- 工作区索引：`~/.ag-kit/workspaces.json`（或 `AG_KIT_INDEX_PATH` 自定义）。
-- 可配合 `--prune-missing` 清理失效路径。
-
-### 2.3 诊断与修复
-```bash
-ag-kit doctor
-ag-kit doctor --fix
-```
-
-- 检查 `.agents` 与 manifest 完整性。
-- 自动重放托管区块与兼容投影。
-
-## 3. 备份与漂移
-
-- 更新前若检测到用户修改冲突，会备份到 `.agents-backup/<timestamp>/`。
-- `manifest.json` 无法解析时，走全量快照备份后再更新。
-
-## 4. MCP（Context7 主备）
-
-默认托管：
-- `context7`: `@upstash/context7-mcp`
-- `context7_backup`: `@iflow-mcp/context7-mcp@1.0.0`
-
-说明：官方不可用时可切备用；配置示例仅使用规范字段（如 `env`），不使用 `values`。
-
-## 5. 卸载注意
-
-不要无条件删除 `.codex`、`.gemini`。推荐仅删除本工具托管目录：
-
-```bash
-rm -rf .agents .agent .agents-backup .gemini
-```
-
-如需删除 `.codex`，请先确认其为本工具托管 legacy。

package/docs/terminology-style-guide.md

@@ -1,69 +0,0 @@
-# 术语风格统一表
-
-本表用于约束仓库内中文文案写法，目标是“中文主叙述、术语级双语、机制文本不变形”。
-
-## 写法规则
-
-1. 中文主叙述：标题、段落、表头、说明文本默认使用中文表达。
-2. 专有名词英文保留：官方名词优先保留英文（如 `Agent（智能体）`、`Strict Mode（严格模式）`、`Task List（任务清单）`）。
-3. 首次双语标注（仅术语级）：同一文档首次出现时写作 `English（中文）`，后续可简写为 `English`。
-4. 禁止标题整句双语：禁止 `中文标题 (English sentence...)` 或 `English title (中文整句...)`。
-5. 禁止段落整句双语：禁止“英文整句 + 中文整句括号翻译”并排出现。
-6. 保留关键字：命令、参数、路径、快捷键、按钮文案保持原样（如 `--fix`、`/workflow-name`、`Command + I`）。
-7. 机制文本例外：代码块、命令块、Frontmatter key、配置键名不做双语拼接。
-8. 示例命令含提示词时：仅翻译 prompt/query（提示词）语义，命令结构保持不变。
-9. 语义优先：不改变机制、不改变行为，仅调整语言表述。
-
-## 统一术语
-
-| 推荐写法 | 可接受别名（仅历史兼容） | 说明 |
-| --- | --- | --- |
-| Agent（智能体） | 智能体 | 平台执行主体；首现必须双语 |
-| Skill（技能） | Skills、技能 | 能力模块；首现必须双语 |
-| Workflow（工作流） | Workflows、工作流 | 任务流程；首现必须双语 |
-| Workspace（工作区） | 工作空间 | 项目作用域 |
-| Global（全局） | Global | 跨工作区作用域 |
-| Allowlist（允许列表） | 允许列表 | 白名单语义 |
-| Denylist（拒绝列表） | 拒绝列表 | 黑名单语义 |
-| Strict Mode（严格模式） | Strict Mode | 安全策略组合；首现必须双语 |
-| Sandboxing（终端沙箱） | Sandboxing | 命令执行隔离；首现必须双语 |
-| Artifact（产物） | Artifacts、产物 | 过程与结果载体；首现必须双语 |
-| Command（命令面板） | Command | 内联指令入口；首现必须双语 |
-| MCP Store（MCP 商店） | MCP Store | MCP 连接入口；首现必须双语 |
-| Browser Subagent（浏览器子智能体） | Browser Subagent | 浏览器操作代理；首现必须双语 |
-| Task List（任务清单） | Task List | 任务追踪产物；首现必须双语 |
-| Implementation Plan（实施计划） | Implementation Plan | 计划产物；首现必须双语 |
-| Knowledge（知识库） | Knowledge | 持久化知识能力；首现必须双语 |
-
-## 双语边界（强制）
-
-- 允许（术语级）：
-  - `Orchestrator skill（编排器技能）`
-  - `MCP（模型上下文协议）`
-- 禁止（整句级）：
-  - `This skill routes to sub-skills.（此技能会路由到子技能。）`
-  - `## 移动端设计系统 (Mobile Design System)`
-
-## 首次标注模板
-
-- 正文首现：`Agent（智能体）`、`Workflow（工作流）`、`MCP（模型上下文协议）`
-- 后续正文：`Agent`、`Workflow`、`MCP`
-- 禁止写法：`智能体（Agent）` 作为主格式、`Agent智能体`（无括号）、`Agent/智能体`（斜杠混写）、`中文标题 (English sentence)`
-
-## 示例命令中的提示词翻译
-
-- 目标：让示例命令在中文语境下可直接复用，同时不破坏命令机制。
-- 规则：只翻译自然语言提示词；命令、参数、路径、开关、子命令保持原样。
-- 示例：
-  - 原文：`python scripts/search.py "fintech crypto" --design-system`
-  - 推荐：`python scripts/search.py "金融 科技 加密" --design-system`
-  - 推荐：`python scripts/search.py "为金融科技产品生成设计系统关键词" --design-system`
-
-## 当前覆盖范围（2026-02）
-
-- `.agent/**/*.md`（含 `agents/`、`skills/`、`workflows/`、`ARCHITECTURE.md`）
-- `README.md`
-- `AGENT_FLOW.md`
-- `docs/*.md`
-
-后续新增文档默认遵循本表；若与上游机制冲突，先按 `reference/antigravity-kit` 对齐结构，再做语义汉化。