[Docs] 中文帮助文档路径与机制描述过时，与英文官方文档不一致

Kimi Code CLI 中文文档反馈

问题概述

Kimi Code CLI 的中文帮助文档与英文官方文档存在路径和机制描述不一致的情况，中文文档已经过时，容易误导中国用户。

---

存在问题的文档

• 中文文档（过时）：https://www.kimi.com/zh-cn/help/kimi-code/cli-customization

---

中文文档中的错误/过时内容

1. 配置文件夹名称错误

中文文档写：

Kimi Code CLI 使用 ~/.kimi/config.toml 作为全局配置文件

并在后续多处使用 ~/.kimi/AGENTS.md 作为全局 system prompt 路径。

实际情况：最新版 Kimi Code CLI 的数据根目录是 ~/.kimi-code/，对应的文件应为：

• ~/.kimi-code/config.toml
• ~/.kimi-code/AGENTS.md

~/.kimi/ 文件夹在当前版本中不存在。

2. --system-prompt 启动参数

中文文档写：

使用 --system-prompt 参数在启动时指定。

实际情况：英文官方文档中未提及 --system-prompt 参数。当前自定义主 agent system prompt 的推荐方式是：

• 通过 ~/.kimi-code/SYSTEM.md 覆盖默认主 agent 的 system prompt（目前仅在 kimi web 和 kimi -p + KIMI_CODE_EXPERIMENTAL_FLAG=1 下生效）
• 通过 --agent / --agent-file 选择自定义 agent（目前也仅在 kimi -p 实验模式下生效）

3. AGENTS.md 与 SYSTEM.md 的语义混淆

中文文档将 AGENTS.md 描述为"全局/项目级 system prompt"，并称"项目级配置会覆盖全局配置"。

实际情况（参考英文文档）：

• AGENTS.md 是工作区参考指令（workspace instruction / reference data），通过 ${agents_md} 注入到 prompt 中，TUI 也生效。
• SYSTEM.md 才是用于覆盖主 agent 完整 system prompt 的文件。
• 两者机制不同，不应把 AGENTS.md 直接称为 system prompt。

---

正确的英文官方文档参考

• 总入口：https://www.kimi.com/code/docs/en/
• Agents / Sub-Agents（含 AGENTS.md 与 SYSTEM.md 说明）：https://www.kimi.com/code/docs/en/kimi-code-cli/customization/agents.html
• 配置文件说明（含 ~/.kimi-code/config.toml）：https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/config-files.html
• Hooks 机制：https://www.kimi.com/code/docs/en/kimi-code-cli/customization/hooks.html
• Agent Skills：https://www.kimi.com/code/docs/en/kimi-code-cli/customization/skills.html

---

建议修复

1. 将中文文档中的 ~/.kimi/ 统一更新为 ~/.kimi-code/。
2. 删除或修正关于 --system-prompt 启动参数的描述，改为指向 SYSTEM.md 或自定义 agent 文件。
3. 区分 AGENTS.md（参考指令）和 SYSTEM.md（系统提示覆盖）的语义，避免用户混淆。
4. 建立中英文文档同步机制，避免 EN 版已更新而 CN 版滞后。

---

复现环境

• 操作系统：Windows 11
• 实际观测到的数据目录：C:/Users/xdeca/.kimi-code/（.kimi 文件夹不存在）

---

整理时间：2026-07-26

Start with the Chinese page at kimi.com/zh-cn/help/kimi-code/cli-customization and compare it with the English Agents, configuration, Hooks, and Agent Skills pages linked in the issue. Update the Chinese documentation so paths, --system-prompt guidance, and the distinct AGENTS.md and SYSTEM.md semantics match the English documentation; done when the outdated examples and explanations are corrected.