@mison/ag-kit-cn 2.0.1 → 3.0.0

package/docs/official/README.md

@@ -1,53 +0,0 @@
-# 官方文档本地归档
-
-本目录用于保存官方规范文档的本地快照，作为本仓库在 Antigravity + Codex 双适配时的对照基线。
-
-- 归档时间：2026-02-12
-- 归档方式：先抓取官方源，再整理为中文 Markdown 版本（不改机制语义）
-- 证据索引：`docs/official/sources-index.md`（记录来源 URL、拉取时间、SHA256）
-
-## Antigravity
-
-- `docs/official/antigravity/agent-modes-settings.md`
-  - 来源：`https://antigravity.google/docs/agent-modes-settings`
-  - 抓取源：`https://antigravity.google/assets/docs/agent/agent-modes-settings.md`
-- `docs/official/antigravity/rules-workflows.md`
-  - 来源：`https://antigravity.google/docs/rules-workflows`
-  - 抓取源：`https://antigravity.google/assets/docs/agent/rules-workflows.md`
-- `docs/official/antigravity/skills.md`
-  - 来源：`https://antigravity.google/docs/skills`
-  - 抓取源：`https://antigravity.google/assets/docs/agent/skills.md`
-
-## Codex
-
-- `docs/official/codex/config-basic.md`
-  - 来源：`https://developers.openai.com/codex/config-basic`
-  - 抓取源：`https://developers.openai.com/codex/config-basic.md`
-- `docs/official/codex/config-advanced.md`
-  - 来源：`https://developers.openai.com/codex/config-advanced`
-  - 抓取源：`https://developers.openai.com/codex/config-advanced.md`
-- `docs/official/codex/config-reference.md`
-  - 来源：`https://developers.openai.com/codex/config-reference`
-  - 抓取源：`https://developers.openai.com/codex/config-reference.md`
-- `docs/official/codex/config-sample.md`
-  - 来源：`https://developers.openai.com/codex/config-sample`
-  - 抓取源：`https://developers.openai.com/codex/config-sample.md`
-- `docs/official/codex/rules.md`
-  - 来源：`https://developers.openai.com/codex/rules`
-  - 抓取源：`https://developers.openai.com/codex/rules.md`
-- `docs/official/codex/agents-md.md`
-  - 来源：`https://developers.openai.com/codex/guides/agents-md`
-  - 抓取源：`https://developers.openai.com/codex/guides/agents-md.md`
-- `docs/official/codex/mcp.md`
-  - 来源：`https://developers.openai.com/codex/mcp`
-  - 抓取源：`https://developers.openai.com/codex/mcp.md`
-- `docs/official/codex/skills.md`
-  - 来源：`https://developers.openai.com/codex/skills`
-  - 抓取源：`https://developers.openai.com/codex/skills.md`
-
-## 更新建议
-
-后续更新时，优先覆盖本目录快照，再做差异评审：
-
-1. 对比上次归档与新版官方文档差异。
-2. 若差异影响本仓库机制，再同步到 `docs/`、`.agent/` 相关规范文档。

package/docs/official/antigravity/agent-modes-settings.md

@@ -1,64 +0,0 @@
----
-slug: agent-modes-settings
-section: 代理
-title: Agent 模式与设置
-path:
-  - 代理
-  - 模式与设置
----
-
-# Agent 模式与设置（中文整理）
-
-> 来源：`https://antigravity.google/docs/agent-modes-settings`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-## 会话级模式
-
-开始新的 Agent 会话时，用户可以选择不同模式：
-
-- `Planning`：先规划后执行，适合深度研究、复杂任务、协作任务。该模式下，Agent 会使用任务分组、产出 Artifacts，并在执行前进行更充分的分析与规划。
-- `Fast`：直接执行，适合简单且局部的任务，例如重命名变量、执行少量命令等，强调速度。
-
-## 全局设置
-
-全局设置位于设置面板的 `Agent` 标签页，影响所有会话。重点配置如下。
-
-### Artifact 审阅策略
-
-可选项：
-
-- `Always Proceed`：Agent 不等待人工审阅，继续执行。
-- `Request Review`：Agent 在请求审阅后停止，等待用户确认和补充意见。
-
-适用建议：
-
-- 需要严格把关实施计划时，使用 `Request Review`。
-- 追求流程速度且信任当前指令时，使用 `Always Proceed`。
-
-### 终端命令自动执行
-
-针对终端命令生成工具：
-
-- `Request Review`：默认不自动执行命令（允许名单中的命令可自动执行）。
-- `Always Proceed`：默认自动执行命令（拒绝名单中的命令例外）。
-
-补充规则：
-
-- 允许名单（Allow list）和拒绝名单（Deny list）可在 `Agent` 设置中配置。
-- 设置变更仅对后续新消息生效，不影响当前正在进行的回复。
-- 在 Unix shell 中，规则按“命令 token 前缀匹配”。
-- 在 PowerShell 中，规则可匹配命令 token 的任意连续子序列。
-
-### 非工作区文件访问
-
-该选项控制 Agent 是否可访问和编辑当前工作区之外的文件。
-
-默认情况下，Agent 仅能访问：
-
-- 当前工作区文件
-- 应用根目录 `~/.antigravity/` 下的 Antigravity 相关数据（如 Artifacts、Knowledge Items）
-
-风险提示：
-
-- 开启该能力可能暴露本地敏感信息或密钥，请谨慎使用。

package/docs/official/antigravity/rules-workflows.md

@@ -1,96 +0,0 @@
----
-slug: rules-workflows
-section: 代理
-title: 规则与工作流
-path:
-  - 代理
-  - 规则与工作流
----
-
-# 规则与工作流（中文整理）
-
-> 来源：`https://antigravity.google/docs/rules-workflows`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-# Rules（规则）
-
-Rules 是用户手动定义的约束，可在全局和工作区层级生效，用于把 Agent 的行为对齐到你的团队规范、技术栈和个人风格。
-
-## 快速开始
-
-1. 在编辑器 Agent 面板顶部点击 `...` 打开 Customizations。
-2. 进入 `Rules` 面板。
-3. 点击 `+ Global` 创建全局规则，或点击 `+ Workspace` 创建工作区规则。
-
-规则文件本质是 Markdown 文档。每个规则文件上限为 `12,000` 字符。
-
-## 全局规则
-
-- 路径：`~/.gemini/GEMINI.md`
-- 作用域：所有工作区
-
-## 工作区规则
-
-- 路径：`<workspace-root>/.agent/rules/`
-- 作用域：当前工作区（或对应 Git 根目录）
-
-## 规则激活方式
-
-每条规则可配置激活方式：
-
-- `Manual`：通过输入框 `@提及` 手动启用。
-- `Always On`：始终启用。
-- `Model Decision`：由模型根据规则自然语言描述决定是否启用。
-- `Glob`：按文件匹配模式启用（例如 `*.js`、`src/**/*.ts`）。
-
-## `@` 引用机制
-
-规则文件可通过 `@filename` 引用其他文件：
-
-- 相对路径：相对于规则文件所在目录解析。
-- 绝对路径：优先按真实绝对路径解析。
-- 若绝对路径不存在，系统会尝试按仓库相对路径解析。
-
-示例：
-
-- `@/path/to/file.md`：先尝试 `/path/to/file.md`，不存在则尝试 `workspace/path/to/file.md`。
-
-# Workflows（工作流）
-
-Workflows 用于把重复性任务固化为“可复用步骤序列”，例如部署、回评审意见、批量检查等。  
-工作流保存为 Markdown 文件，可通过斜杠命令 `/workflow-name` 调用。
-
-与 Rules 的区别：
-
-- Rules：提供长期、可复用的行为约束（提示层）。
-- Workflows：提供结构化执行步骤（流程层）。
-
-## 创建工作流
-
-1. 在 Agent 面板顶部点击 `...` 打开 Customizations。
-2. 进入 `Workflows` 面板。
-3. 点击 `+ Global` 创建全局工作流，或点击 `+ Workspace` 创建工作区工作流。
-
-## 执行工作流
-
-在 Agent 中输入：
-
-```text
-/workflow-name
-```
-
-工作流支持互相调用。例如 `/workflow-1` 的步骤中可包含“调用 `/workflow-2`”和“调用 `/workflow-3`”。
-
-工作流文件包含：
-
-- 标题
-- 描述
-- 有序步骤说明
-
-每个工作流文件上限为 `12,000` 字符。
-
-## 让 Agent 生成工作流
-
-你也可以直接让 Agent 帮你生成工作流。  
-当你已经手动完成一轮完整操作后，Agent 可以利用会话历史自动归纳并产出可复用工作流。

package/docs/official/antigravity/skills.md

@@ -1,147 +0,0 @@
----
-title: 技能
-slug: skills
-path: ['代理', '技能']
----
-
-# Agent 技能（中文整理）
-
-> 来源：`https://antigravity.google/docs/skills`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-Skills 是扩展 Agent 能力的开放标准（见 `https://agentskills.io`）。  
-一个 Skill 是一个目录，至少包含一个 `SKILL.md` 指令文件。
-
-## 什么是 Skill
-
-Skill 是可复用的能力包，通常包含：
-
-- 任务处理指令
-- 最佳实践与约束
-- 可选脚本与资源文件
-
-会话开始时，Agent 先看到所有 Skill 的元信息（名称、描述）。  
-当某个 Skill 与当前任务相关时，Agent 再读取完整 `SKILL.md` 并执行。
-
-## Skill 存放位置
-
-Antigravity 支持两类 Skill：
-
-| 位置 | 作用域 |
-| :--- | :--- |
-| `<workspace-root>/.agent/skills/<skill-folder>/` | 工作区级 |
-| `~/.gemini/antigravity/skills/<skill-folder>/` | 全局级（所有工作区） |
-
-- 工作区 Skill：适合项目专属流程（如部署规范、测试约定）。
-- 全局 Skill：适合跨项目复用的个人工具或通用能力。
-
-## 如何创建 Skill
-
-1. 在 Skill 目录下创建文件夹。
-2. 在该文件夹中创建 `SKILL.md`。
-
-```text
-.agent/skills/
-└── my-skill/
-    └── SKILL.md
-```
-
-`SKILL.md` 示例：
-
-```markdown
----
-name: my-skill
-description: 用于处理某类任务，在需要 X 或 Y 时使用。
----
-
-# 我的 Skill
-
-这里写详细指令。
-
-## 何时使用
-
-- 场景 1
-- 场景 2
-
-## 如何执行
-
-按步骤给出模式、约束、输出要求。
-```
-
-## Frontmatter 字段
-
-| 字段 | 是否必填 | 说明 |
-| :--- | :--- | :--- |
-| `name` | 否 | Skill 唯一标识（建议小写 + 连字符）。省略时默认使用目录名。 |
-| `description` | 是 | 描述 Skill 的用途与触发场景，供 Agent 判断是否启用。 |
-
-建议：
-
-- 用第三人称描述 Skill 行为。
-- 包含关键触发词，便于 Agent 识别。
-
-## 推荐目录结构
-
-`SKILL.md` 是必需项，其他目录可选：
-
-```text
-.agent/skills/my-skill/
-├── SKILL.md        # 必需：核心指令
-├── scripts/        # 可选：执行脚本
-├── examples/       # 可选：示例实现
-└── resources/      # 可选：模板/资源
-```
-
-## Agent 如何使用 Skill
-
-Skill 使用“渐进式加载（progressive disclosure）”模式：
-
-1. **发现**：会话开始时仅加载 Skill 名称和描述。
-2. **激活**：判断相关后才读取完整 `SKILL.md`。
-3. **执行**：按 Skill 指令完成当前任务。
-
-你通常无需显式指定 Skill；Agent 会按上下文决定。  
-如需强制使用，可在对话中点名 Skill。
-
-## 编写最佳实践
-
-### 单一职责
-
-每个 Skill 聚焦一个能力，避免“全能型”大杂烩 Skill。
-
-### 描述精确
-
-`description` 要明确写出“做什么 + 什么时候用”。
-
-### 脚本黑盒化
-
-若包含脚本，优先让 Agent 用 `--help` 理解用法，避免无谓读取完整源码。
-
-### 添加决策分支
-
-复杂 Skill 建议加入“条件分支”说明，帮助 Agent 在不同场景选择正确路径。
-
-## 示例：代码审查 Skill
-
-```markdown
----
-name: code-review
-description: 审查代码中的缺陷、风格问题与最佳实践偏差，适用于 PR 审查与质量检查。
----
-
-# 代码审查 Skill
-
-## 审查清单
-
-1. 正确性：是否满足需求与预期行为？
-2. 边界条件：异常与错误路径是否覆盖？
-3. 风格一致性：是否符合项目规范？
-4. 性能：是否存在明显低效实现？
-
-## 反馈方式
-
-- 说明具体问题位置与影响
-- 解释原因，不只给结论
-- 提供可执行替代方案
-```

package/docs/official/codex/agents-md.md

@@ -1,119 +0,0 @@
-# 使用 AGENTS.md 自定义指令
-
-> 来源：`https://developers.openai.com/codex/guides/agents-md`  
-> 同步日期：2026-02-12  
-> 说明：本文件为官方内容的中文整理版，采用标准 Markdown 语法。
-
-Codex 在执行任务前会读取 `AGENTS.md` 指令链。  
-通过“全局 + 项目 + 子目录”分层指令，你可以让 Agent 在不同仓库中保持一致行为，并允许就近覆盖。
-
-## Codex 如何发现与合并指令
-
-Codex 启动时会构建一次指令链（TUI 通常是每次启动会话时构建）。
-
-### 发现顺序
-
-1. **全局层（Codex Home）**
-   - 目录：`$CODEX_HOME`（默认 `~/.codex`）
-   - 优先读取：`AGENTS.override.md`
-   - 若无再读取：`AGENTS.md`
-   - 同层最多取第一个非空文件
-
-2. **项目层（从项目根到当前目录）**
-   - 每一层目录按顺序检查：
-     - `AGENTS.override.md`
-     - `AGENTS.md`
-     - `project_doc_fallback_filenames` 中定义的备选文件名
-   - 每层目录最多取一个文件
-
-3. **合并顺序**
-   - 从根目录到当前目录依次拼接
-   - 越靠近当前目录的文件越“后出现”，覆盖能力越强
-
-### 大小限制
-
-- 受 `project_doc_max_bytes` 控制（默认 `32 KiB`）
-- 空文件会被跳过
-- 达到上限后停止继续追加
-
-## 创建全局指令
-
-```bash
-mkdir -p ~/.codex
-```
-
-在 `~/.codex/AGENTS.md` 写入跨项目通用规范，例如：
-
-```markdown
-# 全局工作约定
-
-## 代码风格
-- 先保证正确性，再追求优化
-- 变更应尽量小而可回滚
-
-## 输出要求
-- 先给结论，再给依据
-- 明确列出未完成项与风险
-```
-
-## 创建项目级与目录级指令
-
-在仓库根目录放项目总约束：
-
-```text
-repo/
-├── AGENTS.md
-└── services/
-    ├── AGENTS.md
-    └── api/
-        └── AGENTS.md
-```
-
-这样可以形成“总规则 -> 模块规则 -> 子模块规则”的分层覆盖。
-
-## 备选文件名（Fallback）
-
-当目录内不存在 `AGENTS.md` 时，可以通过配置补充候选文件名：
-
-```toml
-project_doc_fallback_filenames = ["TEAM.md", "ASSISTANT.md"]
-```
-
-用途：
-
-- 与历史文档命名兼容
-- 渐进迁移到 `AGENTS.md`
-
-## 验证是否生效
-
-建议检查：
-
-1. `AGENTS.md` 是否在预期目录存在且非空
-2. 项目是否被标记为受信任
-3. `project_doc_max_bytes` 是否过小导致截断
-4. 是否被同层的 `AGENTS.override.md` 覆盖
-
-## 常见问题排查
-
-### 指令没生效
-
-- 检查当前 `cwd` 是否在目标目录链下
-- 检查项目是否不受信任（会跳过项目级配置层）
-- 检查文档是否超限被截断
-
-### 指令互相冲突
-
-- 按目录层级拆分职责
-- 通用规则上移到根目录
-- 细节规则下沉到子目录
-
-### 想临时覆盖全局规则
-
-- 在 `~/.codex` 放置 `AGENTS.override.md`，其优先级高于同层 `AGENTS.md`
-
-## 实践建议
-
-- 全局层只放稳定工作约定
-- 项目根放仓库级规范（测试、提交、架构约束）
-- 子目录放模块级细则（接口契约、边界约束）
-- 指令保持短句、可执行、可验证