# Sub Agents **Repository Path**: xmartms/sub-agents ## Basic Information - **Project Name**: Sub Agents - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-23 - **Last Updated**: 2026-09-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Copilot 子代理池 · 中文汉化版 > **本仓是 [holwon/shared-copilot-agents-dev](https://github.com/holwon/shared-copilot-agents-dev) 的中文汉化翻译仓。** > 仅做语言本地化，不改变任何功能行为。 --- ## 特别鸣谢 **本仓的全部原始内容均由 [@holwon](https://github.com/holwon) 创作。** | | | |---|---| | 🏠 **原仓地址** | **** | | 👤 **原作者** | [holwon](https://github.com/holwon) | | 🔗 **克隆原仓** | `git clone https://github.com/holwon/shared-copilot-agents-dev.git` | 这套子代理池的设计——尤其是「**委派策略**」「**输出卫生**」「**子代理只读边界**」三块——把多代理协作里最容易失控的部分（上下文污染、输出溢出死循环、误改代码）用规则锁死了。**强烈建议优先 star 并使用原仓**，本仓只是让它对中文使用者更易读。 > 如果本汉化仓对你有帮助，请把这份认可给原作者：👉 --- ## 这是什么 一套可直接被 VS Code Copilot 加载的 **子代理（subagent）池 + 委派规则**，包含 8 个子代理、5 份自动加载的指令规则与 1 个技能。 | 目录 | 内容 | |---|---| | `agents/` | 8 个子代理定义 | | `rules/` | 5 份指令规则（`applyTo: **`，自动加载） | | `skills/` | `codebase-memory` —— 首次调用工作流 | | `.agents/skills/` | 已安装技能 `writing-for-agents`（来源见 `skills-lock.json`） | | `.plugin/` | 插件清单 `plugin.json` | ### 子代理一览 | 代理 | 职责 | 权限 | |---|---|---| | `FastExplore` | 代码库探查、调用链追踪、架构问答 | 只读 | | `GitReader` | Git 历史、blame、diff、log 检查 | 严格只读 | | `GitOps` | 提交、分支、推送、PR 流程 | Git 写（仅主代理可调用） | | `CodeExecutor` | 终端执行、构建、后台进程、日志提炼 | 仅终端，不改代码 | | `TestRunner` | 单元/集成测试与类型检查 | 严格只读 | | `DocWriter` | Markdown 文件落盘（规格、PRD、工单） | 仅 `.md` | | `DocTracker` | Markdown 状态标记同步（复选框、`**Status:**`） | 仅 `.md` 状态标记 | | `WebResearcher` | 官方文档、第三方库 API、公开源码检索 | 只读 | ### 指令规则 | 规则 | 作用 | |---|---| | `delegation-policy` | **核心**：委派映射表、读写边界、交接协议 | | `run-subagent-delegation` | 强制要求：该委派的调查必须走子代理 | | `code-usage-first` | 优先用符号感知的 usages，而非盲目关键词搜索 | | `agent-output-hygiene` | 防工具输出溢出死循环（溢出文件只许用文件读取工具读） | | `output-formatting` | 输出语言与格式要求、禁止占位代码 | --- ## 翻译原则：什么译了，什么**没**译 本仓只翻译**自然语言**部分。以下内容**刻意保持英文原样**——这不是漏译，请勿「顺手翻译」，否则会直接破坏功能： | 保留英文的内容 | 原因 | |---|---| | 工具 ID（`#tool:execute/runInTerminal`、`read_file`…） | 工具调用依赖精确标识符，译后无法解析 | | 代理名（`FastExplore`、`@GitReader`…） | 委派路由按名字精确匹配 | | 报告状态令牌（`Blocked`／`Pass`／`Fail`／`Refused`／`DONE`／`CONFLICT`） | 调用方按字面量订阅这些信号，译后收不到 | | 结构标记（`**Status:**`、`- [ ]`、`- [x]`） | 文档状态同步依赖逐字符匹配 | | 命令与开关（`git log --no-pager --no-color`、`Get-Content`…） | 需可直接复制执行；黑名单命令名还有威慑作用 | | 英文强制词（`NEVER`／`MUST`／`ALWAYS`／`CRITICAL`／`EXACTLY ONE`／`STRICTLY FORBIDDEN`） | 承载最强的指令遵循先验，译成中文会显著削弱约束力 | | 技能触发词（`who calls this function`…） | 触发匹配依赖原措辞，故采用「英文 + 中文括注」形式 | | frontmatter 键名、`applyTo` 值、文件路径引用 | YAML 解析与跨文件链接依赖原文 | 换句话说：**中文负责可读性，英文负责可执行性。** --- ## 使用方式 ### 方式一：作为 VS Code 代理插件 整个目录放到 VS Code 的代理插件目录即可被加载（本机实测路径形态）： ``` ~/.vscode/agent-plugins//// ``` 例如：`~/.vscode/agent-plugins/github.com/holwon/shared-copilot-agents-dev/` ### 方式二：取用其中的规则或代理 `rules/` 与 `agents/` 下的单个文件可以独立复制到你的项目或用户级配置中使用，彼此无强依赖（跨文件引用仅出现在输出卫生等少数几处，见文件内的相对路径）。 --- ## 本仓信息 - **本仓远程**： - **上游原仓**： - **翻译基准**：上游 `main` 分支，2026-09-23 时点（上游最后推送 `2026-09-23T01:10:26Z`） - **性质**：静态翻译快照，不跟踪上游更新 若上游有更新，建议以**原仓为准**；也欢迎提 issue 提醒同步。 --- ## 版权与免责声明 - **上游原仓未声明任何开源许可证**（GitHub 显示 `license: null`）。因此本仓**不主张任何授权**，也不声称本仓可再分发。 - 本仓所有原始内容（代理定义、指令规则、技能）的**著作权归原作者 [holwon](https://github.com/holwon) 所有**。本仓仅在原作者作品基础上提供中文翻译，用于学习与交流。 - `.agents/skills/writing-for-agents/` 不属于上述范围：该技能由 skills CLI 从 安装（来源记录见 `skills-lock.json`），**著作权归其各自原作者所有**。 - **若原作者认为本仓存在任何不妥，请联系删除，本仓将立即配合处理。** - 使用本仓内容所产生的一切后果，由使用者自行承担。 --- ## 相关链接 - 🏠 原仓： - 👤 原作者：