功能规格说明：Init 斜杠命令

创建日期：2026-01-27

用户场景与测试 （必填）

用户故事：为 Agent 初始化仓库（优先级：P1）

作为为 Wave Agent 设置新仓库的开发者，我希望运行一个简单的命令，自动分析代码库并为未来的 agent 实例生成指导文件。

为什么是这个优先级：这是请求的核心功能。它启用了仓库对 AI agent 的"入职"，这是提高生产力的关键第一步。

独立测试：可以通过在没有 AGENTS.md 文件的仓库中运行 /init 并验证基于代码库分析创建了带有正确前缀和相关内容的 AGENTS.md 文件来测试。

验收场景：

1. 假设仓库没有 AGENTS.md，当用户输入 /init 时，则 agent 应该分析代码库（构建命令、架构、现有规则）并创建带有必需前缀的 AGENTS.md。
2. 假设仓库有现有的 AGENTS.md，当用户输入 /init 时，则 agent 应该分析代码库并建议对现有 AGENTS.md 的改进或更新，而不是盲目覆盖。
3. 假设仓库有 .cursorrules 或 .github/copilot-instructions.md，当用户输入 /init 时，则 agent 应该将这些规则的重要部分纳入生成的 AGENTS.md。

---

用户故事：Init 命令的可发现性（优先级：P2）

作为 Wave Agent CLI 的用户，我希望看到 /init 作为可用命令，以便我知道它存在以及如何使用它。

为什么是这个优先级：可发现性是新功能的关键。如果用户不知道命令存在，他们就不会使用它。

独立测试：可以通过在 CLI 中输入 / 或帮助命令并验证 /init 被列出并带有简短描述来测试。

验收场景：

1. 假设 CLI 处于活动状态，当用户触发命令补全或帮助时，则 /init 应该作为有效选项显示。

---

边界情况

• 代码库为空或没有可识别的结构怎么办？ agent 应该提供带有必需前缀的最小 AGENTS.md，并注明未检测到特定架构，而不是失败或臆造。
• 系统如何处理只读文件系统？ agent 应该通知用户由于权限问题无法创建或修改 AGENTS.md。
• 如果内置 init skill 的 SKILL.md 在预期位置缺失怎么办？ 命令应该使用提示的硬编码版本，因为它是内置命令。

假设

• 内置 init skill 的 SKILL.md 文件位于相对于 agent 执行环境的稳定路径，或与 agent 捆绑。
• agent 有足够的权限读取整个仓库并写入根目录。
• 用户意图让 AGENTS.md 成为任何在仓库上工作的 AI agent 的共享资源，而不仅仅是 Wave Agent。