当前位置：首页 > news >正文

github-copilot源码调研kimi-cli:没有显示它支持全局规则文件

news 2026/5/11 21:36:12

结论（直接回答）

从源码看：没有内置的「全局用户级 AGENTS.md（或等价的全局 rules 文件）」读取逻辑。AGENTS.md 是按“工作目录 / 项目”查找并注入到运行时（即每个项目/工作目录有自己的 AGENTS.md）。也就是说，官方行为是项目级（work_dir）规则，不会自动去 ~/.kimi/ 之类的共享目录读取全局 AGENTS.md。

关键证据（源码片段 —— 我直接引用了仓库实现）

Python：load_agents_md 只在工作目录查找 AGENTS.md / agents.md

async def load_agents_md(work_dir: KaosPath) -> str | None:paths = [work_dir / "AGENTS.md",work_dir / "agents.md",]for path in paths:if await path.is_file():logger.info("Loaded agents.md: {path}", path=path)return (await path.read_text()).strip()logger.info("No AGENTS.md found in {work_dir}", work_dir=work_dir)return None

Rust（kagent）对应实现，行为一致：只在 work_dir 查找

pub async fn load_agents_md(work_dir: &KaosPath) -> Option<String> {let candidates = [work_dir.clone() / "AGENTS.md",work_dir.clone() / "agents.md",];for path in candidates {if path.is_file(true).await {if let Ok(text) = path.read_text().await {info!("Loaded agents.md: {}", path.to_string_lossy());return Some(text.trim().to_string());}}}info!("No AGENTS.md found in {}", work_dir.to_string_lossy());None
}

/init slash 命令会在临时目录生成并把生成结果写回「工作目录」的 AGENTS.md（也说明 AGENTS.md 是项目级的产物/目标）

@registry.command
async def init(soul: KimiSoul, args: str):"""Analyze the codebase and generate an `AGENTS.md` file"""...agents_md = load_agents_md(soul.runtime.builtin_args.KIMI_WORK_DIR)system_message = system("The user just ran `/init` slash command. ""The system has analyzed the codebase and generated an `AGENTS.md` file. "f"Latest AGENTS.md file content:\n{agents_md}")...

共享/用户目录的位置定义在 get_share_dir；项目的配置（~/.kimi/config.toml 等）存放在该 share dir，但没有证据显示 AGENTS.md 会从这里被作为“全局规则文件”加载

def get_share_dir() -> Path:"""Get the share directory path."""if share_dir := os.getenv("KIMI_SHARE_DIR"):share_dir = Path(share_dir)else:share_dir = Path.home() / ".kimi"share_dir.mkdir(parents=True, exist_ok=True)return share_dir

解释与补充

运行时（Runtime.create / builtin_args）把 KIMI_AGENTS_MD 注入到系统提示词里，内容来自 load_agents_md(work_dir)（即项目工作目录的 AGENTS.md）。这说明 agent 的规则/提示是从当前工作目录的 AGENTS.md 取得，而不是从用户分享目录或某个全局位置。
仓库内确实有多个 AGENTS.md（项目根、rust 子目录等），那是源码/维护文档的一部分，不等同于“用户全局规则文件”。
代码里已有明确的“share dir”（~/.kimi）用于存放 config.toml、skills 等（见 get_share_dir），但没有实现读取 ~/.kimi/AGENTS.md 作为全局规则源。

如果你需要「全局规则文件」的行为（可选实现/建议）

最简单的用法：把常用的 AGENTS.md 模板放在某个位置（例如 ~/.kimi/AGENTS.md），在新项目中手动复制一份到项目根：cp ~/.kimi/AGENTS.md ./AGENTS.md。或者在项目初始化脚本里自动复制。
代码改动建议（如果想改源码以自动支持全局 AGENTS.md）：
- 修改 load_agents_md(work_dir) 的搜索顺序，例如先查 work_dir/AGENTS.md，再查 get_share_dir()/AGENTS.md，最后返回 None。实现位置：src/kimi_cli/soul/agent.py（Python）和 rust/kagent/src/soul/agent.rs（Rust）。
如果你想，我可以：
- 给出一个小的 patch 示例（Python）来让运行时在 ~/.kimi/AGENTS.md 上做回退读取；
- 或者把一份推荐的 AGENTS.md 模板例子写给你，以便你把它放到 ~/.kimi/ 或项目模板中。

额外说明（检索说明）

我用代码搜索查看了相关实现（load_agents_md、Runtime.create、slash.init、get_share_dir 等）。搜索结果可能受限制（可能不包含所有匹配），你可以在仓库直接搜索关键字确认更多位置：
https://github.com/MoonshotAI/kimi-cli/search?q=AGENTS.md

如果你要我继续做