refactor(cli): CLI 输出统一为英文

Author: StringKe

internal/cli/budget.go

@@ -25,14 +25,14 @@ func newBudgetCmd() *cobra.Command {
 	)
 	cmd := &cobra.Command{
 		Use:   "budget",
-		Short: "估算 source 与实际 target 输出的 LLM 上下文消耗",
+		Short: "Estimate LLM context usage of sources and rendered target output",
 		RunE: func(cmd *cobra.Command, _ []string) error {
 			return runBudget(cmd, asJSON, rendered || len(targets) > 0, targets)
 		},
 	}
-	cmd.Flags().BoolVar(&asJSON, "json", false, "结构化 JSON 输出")
-	cmd.Flags().BoolVar(&rendered, "rendered", false, "显示启用 target 的实际 root 与 sidecar 体积")
-	cmd.Flags().StringSliceVar(&targets, "target", nil, "限定 rendered target，可重复")
+	cmd.Flags().BoolVar(&asJSON, "json", false, "Structured JSON output")
+	cmd.Flags().BoolVar(&rendered, "rendered", false, "Show actual root and sidecar sizes for enabled targets")
+	cmd.Flags().StringSliceVar(&targets, "target", nil, "Limit rendered targets, repeatable")
 	return cmd
 }
 
@@ -148,7 +148,7 @@ func runBudget(cmd *cobra.Command, asJSON, rendered bool, targets []string) erro
 	pf := func(format string, a ...any) { _, _ = fmt.Fprintf(out, format, a...) }
 	pl := func(s string) { _, _ = fmt.Fprintln(out, s) }
 
-	pf("总文档数 %d   总 rules 字节 %d   估算总 tokens %d\n\n",
+	pf("Total docs %d   total rules bytes %d   estimated total tokens %d\n\n",
 		len(r.Docs), r.TotalRulesBytes, r.TotalTokens)
 	pf("%-50s %-12s %10s %10s\n", "PATH", "TYPE", "BYTES", "~TOKENS")
 	pl(strings.Repeat("-", 86))
@@ -304,14 +304,15 @@ func collectBudgetSkillPackageFiles(docs []*parser.Document, files []source.File
 	}
 }
 
-// isMarkdownFile 判断 path 后缀是否为 markdown
+// isMarkdownFile reports whether the path has a markdown suffix
 func isMarkdownFile(p string) bool {
 	lower := strings.ToLower(p)
 	return strings.HasSuffix(lower, ".md") || strings.HasSuffix(lower, ".markdown")
 }
 
-// isSkillSubdirMarkdownFile 判断是否 SKILL package 子目录的辅助 markdown
-// （与 runner.isSkillSubdirMarkdown 等价；cli 包独立维护避免跨包导出私有 helper）
+// isSkillSubdirMarkdownFile reports whether p is an auxiliary markdown file
+// inside a SKILL package subdirectory (same rule as runner.isSkillSubdirMarkdown;
+// maintained separately here to avoid exporting a private cross-package helper)
 func isSkillSubdirMarkdownFile(p string) bool {
 	return strings.HasPrefix(p, "skills/") && strings.Count(p, "/") >= 3
 }

internal/cli/budget_test.go

@@ -236,7 +236,7 @@ func TestIsMarkdownFile(t *testing.T) {
 
 func TestIsSkillSubdirMarkdownFile(t *testing.T) {
 	cases := map[string]bool{
-		"skills/foo/SKILL.md":         false, // 顶层
+		"skills/foo/SKILL.md":         false, // top level
 		"skills/foo/refs/x.md":        true,
 		"skills/foo/scripts/sub/y.md": true,
 		"rules/x.md":                  false,

internal/cli/clean.go

@@ -17,9 +17,9 @@ func newCleanCmd() *cobra.Command {
 	var keepBackups, yes bool
 	cmd := &cobra.Command{
 		Use:   "clean",
-		Short: "清空根目录与平台目录的生成文件，保留 .stdai/",
+		Short: "Remove generated files from root and platform dirs, keep .stdai/",
 		RunE: func(cmd *cobra.Command, _ []string) error {
-			_ = keepBackups // 当前 v1.0：clean 永远保留 .stdai/backups/
+			_ = keepBackups // v1.0: clean always keeps .stdai/backups/
 			_, root := resolveConfigPath()
 			st, err := state.Load(filepath.Join(root, state.StateFile))
 			if err != nil {
@@ -68,15 +68,16 @@ func newCleanCmd() *cobra.Command {
 		},
 	}
 	f := cmd.Flags()
-	f.StringSliceVar(&targets, "target", nil, "仅清理指定 target")
-	f.BoolVar(&keepBackups, "keep-backups", true, "保留 .stdai/backups/")
-	f.BoolVarP(&yes, "yes", "y", false, "跳过确认")
+	f.StringSliceVar(&targets, "target", nil, "Only clean the given target(s)")
+	f.BoolVar(&keepBackups, "keep-backups", true, "Keep .stdai/backups/")
+	f.BoolVarP(&yes, "yes", "y", false, "Skip confirmation")
 	return cmd
 }
 
-// cleanEmptyDirs 删除被清理文件的父目录（若已空）
+// cleanEmptyDirs removes parent dirs of cleaned files when they are empty.
 //
-// 退出条件用 filepath.Dir(dir) == dir 判定 root，跨 OS 安全：
+// The exit condition filepath.Dir(dir) == dir detects the filesystem root
+// and is safe across OSes:
 // Linux/macOS: filepath.Dir("/") == "/"
 // Windows:     filepath.Dir("C:\\") == "C:\\"
 func cleanEmptyDirs(paths []string) {
@@ -86,7 +87,7 @@ func cleanEmptyDirs(paths []string) {
 		for dir != "." && dir != "" {
 			parent := filepath.Dir(dir)
 			if parent == dir {
-				break // 已到 filesystem root
+				break // reached filesystem root
 			}
 			dirs[dir] = true
 			dir = parent
@@ -96,11 +97,11 @@ func cleanEmptyDirs(paths []string) {
 	for d := range dirs {
 		dirList = append(dirList, d)
 	}
-	// 按深度排序，深的先删
+	// Sort by depth so deeper dirs are removed first
 	sort.Slice(dirList, func(i, j int) bool {
 		return len(dirList[i]) > len(dirList[j])
 	})
 	for _, d := range dirList {
-		_ = os.Remove(d) // 非空目录会自然失败，忽略
+		_ = os.Remove(d) // non-empty dirs fail naturally, ignored
 	}
 }

internal/cli/clean_test.go

@@ -17,7 +17,7 @@ func TestCleanCommandRemovesGeneratedFiles(t *testing.T) {
 	setupSyncProject(t, tmp)
 	t.Chdir(tmp)
 
-	// 先 sync 生成 CLAUDE.md / AGENTS.md / .claude/rules/...
+	// first sync to generate CLAUDE.md / AGENTS.md / .claude/rules/...
 	syncCmd := newSyncCmd()
 	syncCmd.SetOut(new(bytes.Buffer))
 	syncCmd.SetErr(new(bytes.Buffer))
@@ -28,7 +28,7 @@ func TestCleanCommandRemovesGeneratedFiles(t *testing.T) {
 		t.Fatal("CLAUDE.md should exist after sync")
 	}
 
-	// clean --yes 跳过交互确认
+	// clean --yes skips interactive confirmation
 	cleanCmd := newCleanCmd()
 	var out bytes.Buffer
 	cleanCmd.SetOut(&out)
@@ -38,13 +38,13 @@ func TestCleanCommandRemovesGeneratedFiles(t *testing.T) {
 		t.Fatalf("clean: %v", err)
 	}
 
-	// 生成文件应被删除
+	// generated files should be removed
 	for _, gone := range []string{"CLAUDE.md", "AGENTS.md", ".claude/rules/style.md"} {
 		if _, err := os.Stat(filepath.Join(tmp, gone)); err == nil {
 			t.Errorf("%s should be removed after clean", gone)
 		}
 	}
-	// .stdai/ 应保留
+	// .stdai/ should be preserved
 	if _, err := os.Stat(filepath.Join(tmp, ".stdai/config.toml")); err != nil {
 		t.Errorf(".stdai should be preserved: %v", err)
 	}
@@ -99,7 +99,7 @@ func TestCleanCommandTargetFilter(t *testing.T) {
 		t.Fatal(err)
 	}
 
-	// 仅 clean claude-code
+	// only clean claude-code
 	cleanCmd := newCleanCmd()
 	cleanCmd.SetOut(new(bytes.Buffer))
 	cleanCmd.SetErr(new(bytes.Buffer))
@@ -108,11 +108,11 @@ func TestCleanCommandTargetFilter(t *testing.T) {
 		t.Fatal(err)
 	}
 
-	// CLAUDE.md 被删
+	// CLAUDE.md is removed
 	if _, err := os.Stat(filepath.Join(tmp, "CLAUDE.md")); err == nil {
 		t.Error("CLAUDE.md should be removed (target=claude-code)")
 	}
-	// AGENTS.md 保留（target 限定为 claude-code）
+	// AGENTS.md stays (target limited to claude-code)
 	if _, err := os.Stat(filepath.Join(tmp, "AGENTS.md")); err != nil {
 		t.Errorf("AGENTS.md should remain when --target claude-code: %v", err)
 	}

internal/cli/explain.go

@@ -12,7 +12,7 @@ import (
 //go:embed explain_text.md
 var explainText string
 
-// explainType 是 stdagent explain --json 输出的单条记录
+// explainType is a single record of `stdagent explain --json` output
 type explainType struct {
 	Type      string `json:"type"`
 	Semantics string `json:"semantics"`
@@ -21,61 +21,61 @@ type explainType struct {
 	ExampleFM string `json:"example_frontmatter"`
 }
 
-// explainTypes 是 5 种 type 的结构化语义，供 --json 输出。
-// 与 explain_text.md 内容对应，保持同步。
+// explainTypes holds the structured semantics of the 5 types for --json output.
+// It mirrors explain_text.md; keep them in sync.
 var explainTypes = []explainType{
 	{
 		Type:      "rules",
-		Semantics: "持续生效的编码、架构和操作约束；由 target 自动加载或按路径匹配。",
-		WhenToUse: "违反会造成真实风险、且值得占用常驻上下文的稳定约束。",
-		WhenNot:   "长背景用 references，按需工作流用 skills，用户模板用 commands。",
-		ExampleFM: "---\ntype: rules\nname: exception-handling\ndescription: Go 错误传播与边界转换\npriority: high\napplyTo:\n  - \"**/*.go\"\n---",
+		Semantics: "Always-on coding, architecture, and operational constraints; auto-loaded by targets or matched by path.",
+		WhenToUse: "Stable constraints whose violation causes real risk and that deserve resident context.",
+		WhenNot:   "Long background goes in references, on-demand workflows in skills, user templates in commands.",
+		ExampleFM: "---\ntype: rules\nname: exception-handling\ndescription: Go error propagation and boundary conversion\npriority: high\napplyTo:\n  - \"**/*.go\"\n---",
 	},
 	{
 		Type:      "skills",
-		Semantics: "AI 根据 description 按需调用的能力包，可携带辅助资源。",
-		WhenToUse: "可复用、有明确结果和成功标准的工作流。",
-		WhenNot:   "持续约束用 rules，用户显式模板用 commands。",
-		ExampleFM: "---\ntype: skills\nname: code-review\ndescription: 审查当前改动并报告正确性、安全和回归问题\n---",
+		Semantics: "Capability packages the AI invokes on demand based on description; may carry supporting resources.",
+		WhenToUse: "Reusable workflows with a clear outcome and success criteria.",
+		WhenNot:   "Ongoing constraints go in rules, explicit user templates in commands.",
+		ExampleFM: "---\ntype: skills\nname: code-review\ndescription: Review current changes and report correctness, security, and regression issues\n---",
 	},
 	{
 		Type:      "commands",
-		Semantics: "用户输入 /command-name 显式触发的操作模板。",
-		WhenToUse: "用户需要主动调用的固定操作。",
-		WhenNot:   "AI 自动判断的流程用 skills，持续约束用 rules。",
-		ExampleFM: "---\ntype: commands\nname: review\ndescription: 审查当前分支改动并生成 review 报告\n---",
+		Semantics: "Operation templates the user triggers explicitly via /command-name.",
+		WhenToUse: "Fixed operations the user wants to invoke directly.",
+		WhenNot:   "AI-judged flows go in skills, ongoing constraints in rules.",
+		ExampleFM: "---\ntype: commands\nname: review\ndescription: Review current branch changes and produce a review report\n---",
 	},
 	{
 		Type:      "references",
-		Semantics: "仅在需要时查阅的架构、协议、API 和长篇背景。",
-		WhenToUse: "不应占用默认上下文但需要保留的领域知识。",
-		WhenNot:   "持续约束用 rules，可执行工作流用 skills。",
-		ExampleFM: "---\ntype: references\nname: transformer-design\ndescription: transformer 协议层架构说明\napplyTo:\n  - \"internal/transformer/**\"\n---",
+		Semantics: "Architecture, protocol, API, and long-form background consulted only when needed.",
+		WhenToUse: "Domain knowledge worth keeping but not worth occupying default context.",
+		WhenNot:   "Ongoing constraints go in rules, executable workflows in skills.",
+		ExampleFM: "---\ntype: references\nname: transformer-design\ndescription: Transformer protocol-layer architecture notes\napplyTo:\n  - \"internal/transformer/**\"\n---",
 	},
 	{
 		Type:      "subagents",
-		Semantics: "在隔离上下文中执行的代理定义。",
-		WhenToUse: "可独立执行、需要专门上下文或可安全并行的任务。",
-		WhenNot:   "当前 session 内的流程用 skills，简单模板用 commands。",
-		ExampleFM: "---\ntype: subagents\nname: code-reviewer\ndescription: 在隔离上下文中审查代码并返回问题清单\n---",
+		Semantics: "Agent definitions executed in an isolated context.",
+		WhenToUse: "Tasks that run independently, need a dedicated context, or parallelize safely.",
+		WhenNot:   "In-session flows go in skills, simple templates in commands.",
+		ExampleFM: "---\ntype: subagents\nname: code-reviewer\ndescription: Review code in an isolated context and return an issue list\n---",
 	},
 }
 
 func newExplainCmd() *cobra.Command {
 	var asJSON bool
 	cmd := &cobra.Command{
 		Use:   "explain [type]",
-		Short: "解释 std-agent 5 种类型（rules/skills/commands/references/subagents）的语义",
-		Long: `输出 std-agent 5 种 type 的语义速查：每种类型的触发语义 / 何时使用 / 何时不用 / 示例 frontmatter。
+		Short: "Explain the semantics of the 5 std-agent types (rules/skills/commands/references/subagents)",
+		Long: `Print a semantics cheat sheet for the 5 std-agent types: trigger semantics / when to use / when not to / example frontmatter for each type.
 
-不带参数时输出全部 5 种。带 type 参数时只输出该 type 一段。
+Without arguments, print all 5 types. With a type argument, print only that type's section.
 
-示例：
+Examples:
 
-    stdagent explain                  # 全部 5 种
-    stdagent explain rules            # 只看 rules
-    stdagent explain --json           # JSON 输出（AI 集成）
-    stdagent explain rules --json     # rules 单项 JSON
+    stdagent explain                  # all 5 types
+    stdagent explain rules            # rules only
+    stdagent explain --json           # JSON output (AI integration)
+    stdagent explain rules --json     # single rules item as JSON
 `,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -89,11 +89,12 @@ func newExplainCmd() *cobra.Command {
 			return writeExplainMarkdown(cmd, filter)
 		},
 	}
-	cmd.Flags().BoolVar(&asJSON, "json", false, "JSON 输出（给 AI / 自动化集成）")
+	cmd.Flags().BoolVar(&asJSON, "json", false, "JSON output (for AI / automation integration)")
 	return cmd
 }
 
-// writeExplainMarkdown 输出 markdown 速查。filter 为空输出全部，否则只输出对应 type 段。
+// writeExplainMarkdown prints the markdown cheat sheet. An empty filter prints
+// everything, otherwise only the matching type's section.
 func writeExplainMarkdown(cmd *cobra.Command, filter string) error {
 	if filter == "" {
 		cmd.Print(explainText)
@@ -110,7 +111,7 @@ func writeExplainMarkdown(cmd *cobra.Command, filter string) error {
 	return nil
 }
 
-// writeExplainJSON 输出 []explainType（全部）或 [explainType]（单项过滤）。
+// writeExplainJSON prints []explainType (all) or [explainType] (single-type filter).
 func writeExplainJSON(cmd *cobra.Command, filter string) error {
 	enc := json.NewEncoder(cmd.OutOrStdout())
 	enc.SetIndent("", "  ")
@@ -137,21 +138,23 @@ func isKnownType(t string) bool {
 	return false
 }
 
-// extractSection 从 explain_text.md 抽出 ## <type> 标题对应的段落（含标题，到下一个 ## 之前）。
+// extractSection extracts the `## <type>` section from explain_text.md
+// (including the header, up to the next `##` header).
 //
-// explain_text.md 用 `## rules` / `## skills` 等二级标题分段，最后有一个 `## 速查表` 总表段。
-// 单项查询时只返回该 type 的段，不包含速查表（避免重复信息）。
+// explain_text.md is divided by `## rules` / `## skills` ... level-2 headers
+// plus a trailing `## Quick reference` summary section. Single-type queries
+// return only that type's section, without the summary (to avoid duplication).
 func extractSection(text, typeName string) string {
 	header := "## " + typeName
 	idx := strings.Index(text, header+"\n")
 	if idx < 0 {
 		return ""
 	}
 	rest := text[idx:]
-	// 找下一个 `## ` 二级标题（注意要在行首）
+	// Find the next `## ` level-2 header (must be at line start)
 	next := strings.Index(rest[len(header):], "\n## ")
 	if next < 0 {
 		return rest
 	}
-	return rest[:len(header)+next+1] // +1 包含 next 之前的换行
+	return rest[:len(header)+next+1] // +1 keeps the newline before next
 }

internal/cli/explain_test.go

@@ -17,13 +17,13 @@ func TestExplainAll(t *testing.T) {
 	}
 	got := out.String()
 	for _, want := range []string{
-		"std-agent 类型",
+		"std-agent types",
 		"## rules",
 		"## skills",
 		"## commands",
 		"## references",
 		"## subagents",
-		"## 选择标准",
+		"## Quick reference",
 		"stdagent budget --rendered",
 	} {
 		if !strings.Contains(got, want) {
@@ -48,7 +48,7 @@ func TestExplainSingle(t *testing.T) {
 	if !strings.Contains(got, "applyTo") {
 		t.Error("rules example frontmatter missing applyTo")
 	}
-	// 不应含其他 type 段
+	// must not contain other type sections
 	for _, other := range []string{"## skills", "## commands", "## references", "## subagents"} {
 		if strings.Contains(got, other) {
 			t.Errorf("single explain rules should not contain %q", other)