fix: CLI缺少参数友好提示、config.yaml注释模板、skill目录结构规范

src/adapters/opencode.ts

@@ -17,9 +17,9 @@ export async function injectOpenCode(projectRoot: string): Promise<void> {
       await writeFile(commandPath, generateCommand(stage, hasChangeName));
     }
 
-    const skillDir = join(projectRoot, SKILLS_DIR);
-    await mkdir(skillDir, { recursive: true });
-    const skillPath = join(skillDir, `rune-${stage}.md`);
+    const skillStageDir = join(projectRoot, SKILLS_DIR, `rune-${stage}`);
+    await mkdir(skillStageDir, { recursive: true });
+    const skillPath = join(skillStageDir, "SKILL.md");
     if (!existsSync(skillPath)) {
       await writeFile(skillPath, generateSkill(stage, hasChangeName));
     }
@@ -31,8 +31,9 @@ export async function injectOpenCode(projectRoot: string): Promise<void> {
     await writeFile(statusCommandPath, generateStatusCommand());
   }
 
-  const skillDir = join(projectRoot, SKILLS_DIR);
-  const statusSkillPath = join(skillDir, "rune-status.md");
+  const statusSkillDir = join(projectRoot, SKILLS_DIR, "rune-status");
+  await mkdir(statusSkillDir, { recursive: true });
+  const statusSkillPath = join(statusSkillDir, "SKILL.md");
   if (!existsSync(statusSkillPath)) {
     await writeFile(statusSkillPath, generateStatusSkill());
   }
@@ -54,9 +55,16 @@ function generateSkill(stage: string, hasChangeName: boolean): string {
   const nameHint = hasChangeName
     ? `将 <变更名> 替换为实际的变更名称。\n`
     : "";
+  const descriptionMap: Record<string, string> = {
+    discuss: "Use when 需要进入 SDD 讨论阶段，自由讨论需求和架构方案",
+    plan: "Use when 需要进入 SDD 规划阶段，生成设计文档和任务清单",
+    build: "Use when 需要进入 SDD 构建阶段，按任务清单逐步实现变更",
+    archive: "Use when 需要进入 SDD 归档阶段，确认变更完成并归档",
+  };
 
   return `---
-description: Rune SDD ${stage} 阶段
+name: rune-${stage}
+description: ${descriptionMap[stage] ?? `Use when 需要执行 SDD ${stage} 阶段`}
 ---
 
 # ${stage} 阶段
@@ -78,7 +86,8 @@ function generateStatusCommand(): string {
 
 function generateStatusSkill(): string {
   return `---
-description: 查看所有 Rune 变更状态
+name: rune-status
+description: Use when 需要查看当前所有 Rune 变更的状态和任务进度
 ---
 
 # 状态查看

src/cli.ts

@@ -149,6 +149,13 @@ function handleError(e: unknown): never {
     printError(new UsageError(`未知命令: ${args.replace(/`/g, "")}`, {
       hint: "运行 rune help 查看所有命令",
     }));
+  } else if (e instanceof Error && e.message.includes("missing required args")) {
+    const match = e.message.match(/command `(\w+)/);
+    const cmd = match ? match[1] : "未知命令";
+    printError(new UsageError(`命令 '${cmd}' 缺少必填参数`, {
+      usage: `rune ${cmd} <change-name>`,
+      hint: `运行 rune help ${cmd} 查看用法`,
+    }));
   } else {
     printError(new InternalError());
   }

src/commands/init.ts

@@ -6,6 +6,37 @@ import { injectOpenCode } from "../adapters/opencode.ts";
 import { injectClaudeCode } from "../adapters/claude-code.ts";
 import { CommandError } from "../cli/errors.ts";
 
+const CONFIG_TEMPLATE = `# Rune 配置文件
+# 
+# 未配置的阶段将使用内置默认配置。
+# 阶段顺序：discuss -> plan -> build -> archive
+#
+# 可配置阶段：
+#   discuss  - 讨论阶段：自由讨论需求和架构
+#   plan     - 规划阶段：生成设计文档和任务清单
+#   build    - 构建阶段：按任务清单逐步实现
+#   archive  - 归档阶段：确认完成并归档变更
+#
+# 示例 - 自定义讨论阶段提示词：
+# stages:
+#   discuss:
+#     prompt: |
+#       你是一位资深软件架构师...
+#
+# 示例 - 自定义规划阶段的文档模板：
+# stages:
+#   plan:
+#     documents:
+#       - name: design
+#         prompt: 生成设计文档
+#         template: |
+#           # {{change-name}} 设计文档
+#       - name: task
+#         prompt: 生成任务清单
+#         template: |
+#           # {{change-name}} 任务清单
+`;
+
 const SUPPORTED_TOOLS: Record<string, (root: string) => Promise<void>> = {
   opencode: injectOpenCode,
   "claude-code": injectClaudeCode,
@@ -30,7 +61,7 @@ export async function runInit(
 
   const configPath = join(runeDir, CONFIG_FILE);
   if (!existsSync(configPath)) {
-    await writeFile(configPath, "stages: {}\n", "utf-8");
+    await writeFile(configPath, CONFIG_TEMPLATE, "utf-8");
   }
 
   for (const tool of tools) {