指南、技能与自定义命令

指南（Guidelines）

指南为智能体提供持久、可复用的上下文：Junie CLI 从 AGENTS.md 读取指南并加到它处理的每个任务里。首次打开项目时，它还会检查其他 AI 智能体的指南/记忆文件，发现后建议导入到 .junie/AGENTS.md。AGENTS.md 是用于指导编码智能体的开放文件格式（带标题、列表和纯文本的标准 Markdown）。发现顺序：1 项目根的 .junie/AGENTS.md；2 项目根的 AGENTS.md，与（若存在的）.junie/playbook.md 和每个 .junie/rules/*.md 合并；3 .junie/guidelines.md 或 .junie/guidelines/ 文件夹（旧格式，仍受支持）。全局指南：~/.junie/AGENTS.md（Windows 为 %USERPROFILE%\.junie\AGENTS.md）定义个人偏好或组织级规则；只有一份时直接用；两者都有时都包含并清楚标注，冲突时项目级优先；内容相同时自动去重。可写的内容：技术栈、约定、本地开发命令表、功能开发与决策原则、UI 与架构、安全与数据处理、测试与贡献规范等。

Agent Skills

技能是带指令、模板、脚本和参考材料的文件夹，为 Junie 提供任务特定的上下文，遵循开放的 Agent Skills 格式，可在各智能体间移植，在 Junie CLI 和 JetBrains IDE 里的 Junie 都可用。与指南的区别：指南随每个提示应用；技能只在匹配当前任务需要时才调用（渐进披露：Junie 知道每个技能的名称和描述，但在判断相关前不读取完整内容）。如果项目已有其他智能体的技能目录（.cursor/skills/、.claude/skills/、.codex/skills/），Junie CLI 会检测并建议导入到 .junie/skills/。典型技能：API 脚手架、代码评审、数据库迁移（Flyway/Liquibase）等。额外的技能目录可用 config.json 的 skill-locations 指定。

自定义斜杠命令

自定义命令加入内置斜杠命令列表（输入 / 时显示）。创建：/commands → Create New Command，填命令名和描述，选范围——项目命令存为 .junie/commands/ 下的 Markdown 文件（可提交版本控制与团队共享），用户命令存在 ~/.junie/commands/（所有本地项目可用）——然后输入并保存提示。/commands 也用来查看、修改、删除。参数：提示里用 $argumentName 关键字传值，例如命令 explain 的提示为「Explain the code in $file and suggest improvements」，调用 /explain file=src/main.kt；值可不加引号或用单/双引号；模板里的所有参数都提供了才会执行，缺少的参数有内联提示，Tab 补全参数名；默认只接收模板里定义的命名参数，在 YAML frontmatter 里加 allowPromptArgument: true 则额外暴露一个 $prompt 参数接收自由文本。每个命令是一个 Markdown 文件（文件名即命令名，如 explain.md），frontmatter 里写 description 等元数据。