@givolt/i3-composer-agent 2.1.0 → 2.2.0

package/.agents/plugins/marketplace.json

@@ -6,8 +6,8 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.1.0",
-      "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
+      "version": "2.2.0",
+      "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "source": {
         "source": "local",
         "path": "./"

package/.claude/commands/i3-build.md

@@ -1,7 +1,19 @@
 ---
-description: Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.
+description: "按任务增量实现、构建、测试、验证并提交；添加 auto 可按已获批准的完整计划执行。"
+# i3-description-source: "description: Implement tasks incrementally — build, test, verify, commit. Add \"auto\" to run the whole plan in one approved pass."
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：按任务增量实现、构建、测试、验证并提交；添加 auto 可按已获批准的完整计划执行。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-incremental-implementation skill alongside i3-composer-agent:i3-test-driven-development.
 
 ## Modes

package/.claude/commands/i3-code-simplify.md

@@ -1,7 +1,19 @@
 ---
-description: Simplify code for clarity and maintainability — reduce complexity without changing behavior
+description: "简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。"
+# i3-description-source: "description: Simplify code for clarity and maintainability — reduce complexity without changing behavior"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-code-simplification skill.
 
 Simplify recently changed code (or the specified scope) while preserving exact behavior:

package/.claude/commands/i3-constraints.md

@@ -1,7 +1,19 @@
 ---
-description: Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md
+description: "访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。"
+# i3-description-source: "description: Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-constraint-driven-development skill.
 
 $ARGUMENTS

package/.claude/commands/i3-plan.md

@@ -1,7 +1,19 @@
 ---
-description: Break work into small verifiable tasks with acceptance criteria and dependency ordering
+description: "把工作拆成带验收标准、验证步骤和依赖顺序的小任务。"
+# i3-description-source: "description: Break work into small verifiable tasks with acceptance criteria and dependency ordering"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：把工作拆成带验收标准、验证步骤和依赖顺序的小任务。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-planning-and-task-breakdown skill.
 
 Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:

package/.claude/commands/i3-review.md

@@ -1,7 +1,19 @@
 ---
-description: Conduct a five-axis code review — correctness, readability, architecture, security, performance
+description: "从正确性、可读性、架构、安全和性能五个维度审查代码。"
+# i3-description-source: "description: Conduct a five-axis code review — correctness, readability, architecture, security, performance"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：从正确性、可读性、架构、安全和性能五个维度审查代码。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-code-review-and-quality skill.
 
 Review the current changes (staged or recent commits) across all five axes:

package/.claude/commands/i3-ship.md

@@ -1,13 +1,26 @@
 ---
-description: Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision
+description: "并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。"
+# i3-description-source: "description: Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-shipping-and-launch skill.
 
 `/i3-ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.
 
 ## Phase A — Parallel fan-out
 
+<!-- i3:ship-dispatch:start -->
 Spawn three subagents concurrently using the Agent tool. **Issue all three Agent tool calls in a single assistant turn so they execute in parallel** — sequential calls defeat the purpose of this command.
 
 In Claude Code, each call passes `subagent_type` matching the persona's `name` field:
@@ -24,6 +37,7 @@ Constraints (from Claude Code's subagent model):
 - If you need teammates that talk to each other instead of just reporting back, use Claude Code Agent Teams and reference these personas as teammate types (see `references/orchestration-patterns.md`).
 
 **Persona resolution.** If you've defined your own `code-reviewer`, `security-auditor`, or `test-engineer` in `.claude/agents/` or `~/.claude/agents/`, those take precedence over this plugin's versions — `/i3-ship` picks up your customizations automatically. This is intentional: plugin subagents sit at the bottom of Claude Code's scope priority table, so user-level definitions win by design.
+<!-- i3:ship-dispatch:end -->
 
 ## Phase B — Merge in main context
 
@@ -65,7 +79,9 @@ Produce a single output:
 
 ## Rules
 
-1. The three Phase A personas run in parallel — never sequentially.
+1. <!-- i3:ship-parallel-rule:start -->
+The three Phase A personas run in parallel — never sequentially.
+<!-- i3:ship-parallel-rule:end -->
 2. Personas do not call each other. The main agent merges in Phase B.
 3. The rollback plan is mandatory before any GO decision.
 4. If any persona returns a Critical finding, the default verdict is NO-GO unless the user explicitly accepts the risk.

package/.claude/commands/i3-spec.md

@@ -1,7 +1,19 @@
 ---
-description: Start spec-driven development — write a structured specification before writing code
+description: "先编写结构化规格、目标、范围与验收标准，再进入实现。"
+# i3-description-source: "description: Start spec-driven development — write a structured specification before writing code"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：先编写结构化规格、目标、范围与验收标准，再进入实现。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-spec-driven-development skill.
 
 Begin by understanding what the user wants to build. Ask clarifying questions about:

package/.claude/commands/i3-test.md

@@ -1,7 +1,19 @@
 ---
-description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern.
+description: "执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。"
+# i3-description-source: "description: Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern."
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-composer-agent:i3-test-driven-development skill.
 
 For new features:

package/.claude/commands/i3-webperf.md

@@ -1,7 +1,19 @@
 ---
-description: Run a web performance audit via the web-performance-auditor persona
+description: "调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。"
+# i3-description-source: "description: Run a web performance audit via the web-performance-auditor persona"
 ---
 
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。
+<!-- i3:zh-CN:end -->
+
 `/i3-webperf` targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
 
 ## Determine the mode

package/.claude-plugin/marketplace.json

@@ -1,16 +1,16 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
   "name": "i3-composer-agent",
-  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
+  "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "owner": {
     "name": "Givolt"
   },
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.1.0",
+      "version": "2.2.0",
       "source": "./",
-      "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
+      "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "homepage": "https://github.com/49780522/i3-composer-agent",
       "license": "MIT",
       "keywords": [

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.1.0",
-  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
+  "version": "2.2.0",
+  "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"
   },

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.1.0",
-  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
+  "version": "2.2.0",
+  "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"
   },
@@ -11,8 +11,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "i3 Composer Agent",
-    "shortDescription": "Engineering workflow skills",
-    "longDescription": "i3 Composer Agent packages 25 engineering skills from Addy Osmani's Agent Skills, covering requirements, planning, implementation, testing, review, and shipping.",
+    "shortDescription": "中文软件工程全流程技能",
+    "longDescription": "i3 Composer Agent 提供 25 项工程技能，覆盖需求、计划、实现、测试、审查与发布，默认使用简体中文。",
     "developerName": "Givolt",
     "category": "Productivity",
     "capabilities": [
@@ -21,8 +21,9 @@
       "Write"
     ],
     "defaultPrompt": [
-      "Help me choose the right engineering workflow for this task",
-      "Plan and implement this change using the relevant i3 Composer Agent"
+      "请使用 i3 Composer Agent 分析需求，以中文给出可验证的实施方案。",
+      "请使用 i3 Composer Agent 审查当前改动，以中文报告问题与验证结果。",
+      "请使用 i3 Composer Agent 检查发布条件，以中文给出 GO/NO-GO 决策和回滚方案。"
     ]
   }
 }

package/.gemini/commands/i3-build.toml

@@ -1,6 +1,18 @@
-description = "Implement tasks incrementally — build, test, verify, commit. Add \"auto\" to run the whole plan in one approved pass."
+description = "按任务增量实现、构建、测试、验证并提交；添加 auto 可按已获批准的完整计划执行。"
+# i3-description-source: "description = \"Implement tasks incrementally — build, test, verify, commit. Add \\\"auto\\\" to run the whole plan in one approved pass.\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：按任务增量实现、构建、测试、验证并提交；添加 auto 可按已获批准的完整计划执行。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-incremental-implementation skill alongside i3-test-driven-development.
 
 ## Modes

package/.gemini/commands/i3-code-simplify.toml

@@ -1,6 +1,18 @@
-description = "Simplify code for clarity and maintainability — reduce complexity without changing behavior"
+description = "简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。"
+# i3-description-source: "description = \"Simplify code for clarity and maintainability — reduce complexity without changing behavior\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：简化代码，降低复杂度，提高可读性与维护性，并保持既有行为不变。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-code-simplification skill.
 
 Simplify recently changed code (or the specified scope) while preserving exact behavior:

package/.gemini/commands/i3-constraints.toml

@@ -1,6 +1,18 @@
-description = "Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md"
+description = "访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。"
+# i3-description-source: "description = \"Define and enforce this project's quality bar — interview, sane defaults, CONSTRAINTS.md\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：访谈并定义项目质量门槛，提供合理默认值，写入 CONSTRAINTS.md 并落实约束。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-constraint-driven-development skill.
 
 $ARGUMENTS

package/.gemini/commands/i3-planning.toml

@@ -1,6 +1,18 @@
-description = "Break work into small verifiable tasks with acceptance criteria and dependency ordering"
+description = "把工作拆成带验收标准、验证步骤和依赖顺序的小任务。"
+# i3-description-source: "description = \"Break work into small verifiable tasks with acceptance criteria and dependency ordering\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：把工作拆成带验收标准、验证步骤和依赖顺序的小任务。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-planning-and-task-breakdown skill.
 
 Read the existing spec (SPEC.md or equivalent) and the relevant codebase sections. Then:

package/.gemini/commands/i3-review.toml

@@ -1,6 +1,18 @@
-description = "Conduct a five-axis code review — correctness, readability, architecture, security, performance"
+description = "从正确性、可读性、架构、安全和性能五个维度审查代码。"
+# i3-description-source: "description = \"Conduct a five-axis code review — correctness, readability, architecture, security, performance\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：从正确性、可读性、架构、安全和性能五个维度审查代码。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-code-review-and-quality skill.
 
 Review the current changes (staged or recent commits) across all five axes:

package/.gemini/commands/i3-ship.toml

@@ -1,6 +1,18 @@
-description = "Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision"
+description = "并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。"
+# i3-description-source: "description = \"Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：并行调用三个专业角色执行发布前检查，主会话汇总 GO/NO-GO 决策与回滚计划。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-shipping-and-launch skill.
 
 `/i3-ship` is a **fan-out orchestrator**. It runs three specialist personas in parallel against the current change, then merges their reports into a single go/no-go decision with a rollback plan. The personas operate independently — no shared state, no ordering — which is what makes parallel execution safe and useful here.

package/.gemini/commands/i3-spec.toml

@@ -1,6 +1,18 @@
-description = "Start spec-driven development — write a structured specification before writing code"
+description = "先编写结构化规格、目标、范围与验收标准，再进入实现。"
+# i3-description-source: "description = \"Start spec-driven development — write a structured specification before writing code\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：先编写结构化规格、目标、范围与验收标准，再进入实现。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-spec-driven-development skill.
 
 Begin by understanding what the user wants to build. Ask clarifying questions about:

package/.gemini/commands/i3-test.toml

@@ -1,6 +1,18 @@
-description = "Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern."
+description = "执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。"
+# i3-description-source: "description = \"Run TDD workflow — write failing tests, implement, verify. For bugs, use the Prove-It pattern.\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：执行 TDD：先编写失败测试，再实现和验证；缺陷使用 Prove-It 模式复现。
+<!-- i3:zh-CN:end -->
+
 Invoke the i3-test-driven-development skill.
 
 For new features:

package/.gemini/commands/i3-webperf.toml

@@ -1,6 +1,18 @@
-description = "Run a web performance audit via the web-performance-auditor persona"
+description = "调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。"
+# i3-description-source: "description = \"Run a web performance audit via the web-performance-auditor persona\""
 
 prompt = """
+<!-- i3:zh-CN:start -->
+## 中文交互与输出
+
+默认使用简体中文回复，包括追问、选项说明、阶段进度、分析、规格、计划、验收、代码审查与发布报告。只有用户明确要求其他语言时才切换；输入中出现英文术语、代码或引用不构成切换语言的要求。
+下文的工程步骤、审批要求、退出条件和工具约束完整有效。英文示例中的人类可读标题、说明和占位内容在实际输出时应译为中文；保留原有信息与验证标准，不删减方法。
+Skill/Command/Agent 标识、文件路径、命令参数、代码/API 名称、工具调用参数、JSON 键/类型/枚举、机器状态、测试期望字面量及引用原文保持原样。生成文档正文用中文，SPEC.md、tasks/plan.md、tasks/todo.md、CONSTRAINTS.md 等约定路径不改名。
+严重程度按原规则判断，面向用户可写“严重（Critical）”“必须修复（Required）”“小问题（Nit）”“可选（Optional）”“建议考虑（Consider）”“仅供参考（FYI）”；High/Medium/Low、APPROVE/REQUEST CHANGES 和 GO/NO-GO 保留其原始语义与机器值。不得因翻译降低门槛，角色不能互相委派。
+
+适用说明：调用 web-performance-auditor 角色审查网页性能与 Core Web Vitals。
+<!-- i3:zh-CN:end -->
+
 /i3-webperf targets web applications specifically. Do not use it for utility libraries, CLIs, or server-only code with no browser-facing output.
 
 ## Determine the mode