@pzy560117/opensuper 0.2.7 → 0.2.8

package/README.md

@@ -69,13 +69,15 @@ opensuper init
 
 `opensuper init` will:
 
-1. Prompt you to select AI platforms (auto-detects existing configs)
-2. Choose install scope: project-level (current directory) or global (home directory)
-3. Select language for OpenSuper skills: English or 中文
+1. Prompt you to select AI platforms (auto-detects existing configs)
+2. Choose install scope: project-level (current directory) or global (home directory)
+3. Select language for OpenSuper skills: English or 中文
 4. Install [OpenSpec](https://github.com/Fission-AI/OpenSpec) skills
 5. Install [Superpowers](https://github.com/obra/superpowers) skills
 6. Deploy OpenSuper skills (in your chosen language) to selected platforms
-7. Create `docs/superpowers/specs/` and `docs/superpowers/plans/` working directories
+7. Create `docs/superpowers/specs/` and `docs/superpowers/plans/` working directories
+
+The OpenSuper skill language also determines the default language for documents generated during OpenSuper orchestration. Choosing 中文 makes `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, and verification reports default to Chinese prose; choosing English makes them default to English prose. Commands, paths, frontmatter keys, code identifiers, package names, and API names stay in their original form.
 
 > [!TIP]
 > update version
@@ -130,9 +132,9 @@ When multiple existing components are found on the same platform, interactive in
 
 | Option | Description |
 |--------|-------------|
-| `--json` | Output npm and skill update results as JSON |
-| `--language <lang>` | Override detected skill language (`en`, `zh`) |
-| `--scope <scope>` | Update only `global` or `project` scope |
+| `--json` | Output npm and skill update results as JSON |
+| `--language <lang>` | Override detected skill language (`en`, `zh`); also determines the default prose language for OpenSuper-generated documents |
+| `--scope <scope>` | Update only `global` or `project` scope |
 
 ## Supported Platforms
 
@@ -157,9 +159,11 @@ When multiple existing components are found on the same platform, interactive in
 
 ## Skills
 
-After `opensuper init`, three groups of skills are installed to the selected platform's `skills/` directory:
-
-### OpenSuper Skills
+After `opensuper init`, three groups of skills are installed to the selected platform's `skills/` directory:
+
+When Chinese OpenSuper skills are installed, OpenSuper passes Chinese output requirements to the OpenSpec and Superpowers skills it invokes, so workflow document prose defaults to Chinese. Installing English skills applies the corresponding English default.
+
+### OpenSuper Skills
 
 | Skill | Description |
 |-------|-------------|

package/assets/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.6",
+  "version": "0.2.8",
   "skills": [
     "opensuper/SKILL.md",
     "opensuper/scripts/opensuper-guard.sh",

package/assets/skills/opensuper/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper
 description: "OpenSuper — OpenSpec + Superpowers dual-star development workflow. Start with /opensuper for automatic phase detection and dispatch to subcommands. Five phases: open → design → build → verify → archive."
 ---
 
-# OpenSuper — OpenSpec + Superpowers Dual-Star Development Workflow
-
-OpenSpec and Superpowers orbit the same goal like a binary star system. OpenSpec handles WHAT, Superpowers handles HOW.
+# OpenSuper — OpenSpec + Superpowers Dual-Star Development Workflow
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+OpenSpec and Superpowers orbit the same goal like a binary star system. OpenSpec handles WHAT, Superpowers handles HOW.
 
 ```
 OpenSpec handles WHAT  — outline, proposal, spec lifecycle, archive

package/assets/skills/opensuper-archive/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-archive
 description: "OpenSuper Phase 5: Archive. Invoke with /opensuper-archive. Sync delta spec to main spec, archive change."
 ---
 
-# OpenSuper Phase 5: Archive (Archive)
-
-## Prerequisites
+# OpenSuper Phase 5: Archive (Archive)
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+## Prerequisites
 
 - Verification passed (Phase 4 complete)
 - Branch handled

package/assets/skills/opensuper-build/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-build
 description: "OpenSuper Phase 3: Plan and Build. Invoke with /opensuper-build. Create plans and choose execution method (subagent or direct) for implementation."
 ---
 
-# OpenSuper Phase 3: Plan and Build (Build)
-
-## Prerequisites
+# OpenSuper Phase 3: Plan and Build (Build)
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+## Prerequisites
 
 - Design Doc has been created (Phase 2 complete)
 - Active change exists
@@ -27,11 +34,12 @@ Proceed to Step 1 after verification passes. The script outputs specific failure
 
 ### 1. Create Plan
 
-**Immediately execute:** Use the Skill tool to load the `superpowers:writing-plans` skill. Skipping this step is prohibited.
-
-After the skill loads, follow its guidance to create a plan. Plan requirements:
-- Save to `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
-- Reference design document, break down into executable tasks
+**Immediately execute:** Use the Skill tool to load the `superpowers:writing-plans` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+After the skill loads, follow its guidance to create a plan. Plan requirements:
+- Save to `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
+- Reference design document, break down into executable tasks
+- Plan prose must be written in English; frontmatter keys, paths, commands, and code identifiers stay in their original form
 - **Plan file header must contain associated metadata**:
 
 ```yaml
@@ -125,9 +133,9 @@ bash "$OPENSUPER_STATE" set <name> build_mode direct
 
 Without `direct_override: true`, `build_mode=direct` in full workflow is blocked by both guard and state transition.
 
-Then, **immediately execute:** Use the Skill tool to load the corresponding skill. Skipping this step is prohibited.
-
-If the selected Superpowers skill is unavailable, stop the process and prompt to install or enable the corresponding skill. Do not substitute this step with normal conversation.
+Then, **immediately execute:** Use the Skill tool to load the corresponding skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+If the selected Superpowers skill is unavailable, stop the process and prompt to install or enable the corresponding skill. Do not substitute this step with normal conversation.
 
 After the skill loads, follow its guidance to execute:
 - Execute tasks according to plan

package/assets/skills/opensuper-design/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-design
 description: "OpenSuper Phase 2: Deep Design. Invoke with /opensuper-design. Produce Design Doc and delta spec through brainstorming."
 ---
 
-# OpenSuper Phase 2: Deep Design (Design)
-
-## Prerequisites
+# OpenSuper Phase 2: Deep Design (Design)
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+## Prerequisites
 
 - Active change exists (proposal.md, design.md, tasks.md)
 - No Design Doc (no corresponding file under `docs/superpowers/specs/`)
@@ -36,11 +43,13 @@ Read `proposal.md` and `design.md` under the active change, organize core conten
 **Immediately execute:** Use the Skill tool to load the `superpowers:brainstorming` skill, ARGUMENTS contains:
 
 ```
-Change: <change-name>
-Proposal summary: <proposal core content>
-Design summary: <design.md architectural decisions>
-Skip context exploration, proceed directly to design questioning.
-```
+Change: <change-name>
+Output language: English
+Proposal summary: <proposal core content>
+Design summary: <design.md architectural decisions>
+Skip context exploration, proceed directly to design questioning.
+Generated Design Docs, delta specs, discussion summaries, and follow-up task prose must be written in English; commands, paths, frontmatter keys, and code identifiers stay in their original form.
+```
 
 Skipping this step is prohibited, and continuing without loading this skill is prohibited.
 

package/assets/skills/opensuper-hotfix/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-hotfix
 description: "OpenSuper preset path: Bug fix / hotfix. Skip brainstorming, directly open → build → verify → archive. Applicable for behavior fixes, scenarios not involving new capability design."
 ---
 
-# OpenSuper Preset Path: Hotfix
-
-Quick bug fix workflow: open → build → verify → archive. Skip brainstorming and full plan, applicable for behavior fixes not involving new capability design.
+# OpenSuper Preset Path: Hotfix
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+Quick bug fix workflow: open → build → verify → archive. Skip brainstorming and full plan, applicable for behavior fixes not involving new capability design.
 
 **Applicable conditions** (all must be met):
 1. Fix bugs in existing functionality, no new capability
@@ -33,9 +40,9 @@ OPENSUPER_ARCHIVE="${OPENSUPER_ARCHIVE:-$(find "${OPENSUPER_SEARCH_ROOTS[@]}" -p
 
 Reuse OpenSuper open capability to create change, but use hotfix defaults: do not execute `openspec-explore` long exploration, directly enter streamlined change creation.
 
-**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill. Skipping this step is prohibited.
-
-After the skill loads, follow its guidance to create streamlined artifacts:
+**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+After the skill loads, follow its guidance to create streamlined artifacts:
   - `proposal.md` — problem description + root cause analysis + fix goal (no solution comparison needed)
   - `design.md` — fix solution (one is enough, no multi-solution comparison needed)
   - `tasks.md` — fix task list

package/assets/skills/opensuper-open/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-open
 description: "OpenSuper Phase 1: Open. Invoke with /opensuper-open. Explore ideas through OpenSpec and create change structure (proposal + design + tasks)."
 ---
 
-# OpenSuper Phase 1: Open
-
-## Prerequisites
+# OpenSuper Phase 1: Open
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+## Prerequisites
 
 - No active change, or user wishes to create a new change
 
@@ -28,13 +35,15 @@ fi
 
 ### 1. Explore Idea
 
-**Immediately execute:** Use the Skill tool to load the `openspec-explore` skill. Skipping this step is prohibited.
-
-After the skill loads, freely explore the problem space following its guidance.
+**Immediately execute:** Use the Skill tool to load the `openspec-explore` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+After the skill loads, freely explore the problem space following its guidance. Exploration notes, problem breakdowns, and candidate solutions must be written in English.
 
 ### 2. Create Change Structure
 
-**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill. If user intent is unclear and needs to form a proposal first, load `openspec-propose` instead. Skipping this step is prohibited.
+**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill and pass this requirement: `Output language: English`. If user intent is unclear and needs to form a proposal first, load `openspec-propose` instead and pass the same English output requirement. Skipping this step is prohibited.
+
+The generated `proposal.md`, `design.md`, and `tasks.md` prose must be written in English; commands, paths, field names, and code identifiers stay in their original form.
 
 Confirm the following artifacts have been created:
 

package/assets/skills/opensuper-tweak/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-tweak
 description: "OpenSuper preset path: Non-bug small changes (tweak). Skip brainstorming and full plan, directly open → lightweight build → light verify → archive. Applicable for copy, configuration, documentation or prompt local optimization."
 ---
 
-# OpenSuper Preset Path: Tweak
-
-Tweak is a preset workflow of OpenSuper's five-phase capabilities, not a separate parallel process. It reuses open, build, verify, archive capabilities, only skipping brainstorming and full plan.
+# OpenSuper Preset Path: Tweak
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+Tweak is a preset workflow of OpenSuper's five-phase capabilities, not a separate parallel process. It reuses open, build, verify, archive capabilities, only skipping brainstorming and full plan.
 
 Applicable for small-scale non-bug changes, such as copy adjustments, configuration adjustments, documentation or prompt local optimization.
 
@@ -36,9 +43,9 @@ OPENSUPER_ARCHIVE="${OPENSUPER_ARCHIVE:-$(find "${OPENSUPER_SEARCH_ROOTS[@]}" -p
 
 Reuse OpenSuper open capability to create change, but use tweak defaults: do not execute `openspec-explore` long exploration, directly enter streamlined change creation.
 
-**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill. Skipping this step is prohibited.
-
-After the skill loads, follow its guidance to create streamlined artifacts:
+**Immediately execute:** Use the Skill tool to load the `openspec-new-change` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+After the skill loads, follow its guidance to create streamlined artifacts:
   - `proposal.md` — change motivation + goals + scope
   - `design.md` — brief implementation description (no solution comparison needed)
   - `tasks.md` — not exceeding 3 tasks

package/assets/skills/opensuper-verify/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-verify
 description: "OpenSuper Phase 4: Verify and Complete. Invoke with /opensuper-verify. Verify implementation matches design, handle development branch."
 ---
 
-# OpenSuper Phase 4: Verify and Complete (Verify)
-
-## Prerequisites
+# OpenSuper Phase 4: Verify and Complete (Verify)
+
+## Output Language Contract
+
+- Output language: English.
+- This skill writes all user-facing responses and generated documents in English by default, including `proposal.md`, `design.md`, `tasks.md`, delta specs, Design Docs, Plans, verification reports, and archive notes.
+- Keep commands, paths, frontmatter keys, code identifiers, package names, and API names in their original form.
+- Use another prose language only when the user explicitly requests it.
+
+## Prerequisites
 
 - Code has been committed (Phase 3 complete)
 - All tasks in tasks.md are complete
@@ -79,9 +86,9 @@ bash "$OPENSUPER_STATE" transition <name> verify-fail
 
 When scale assessment result is "large":
 
-**Immediately execute:** Use the Skill tool to load the `openspec-verify-change` skill. Skipping this step is prohibited.
-
-After the skill loads, follow its guidance to verify. Check items:
+**Immediately execute:** Use the Skill tool to load the `openspec-verify-change` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
+
+After the skill loads, follow its guidance to verify. Check items:
 1. All tasks in tasks.md completed (`[x]`)
 2. Implementation matches design.md design decisions
 3. Implementation matches brainstorming design document
@@ -104,7 +111,7 @@ bash "$OPENSUPER_STATE" transition <name> verify-fail
 
 ### 3. Completion (Superpowers)
 
-**Immediately execute:** Use the Skill tool to load the `superpowers:finishing-a-development-branch` skill. Skipping this step is prohibited.
+**Immediately execute:** Use the Skill tool to load the `superpowers:finishing-a-development-branch` skill and pass this requirement: `Output language: English`. Skipping this step is prohibited.
 
 If `superpowers:finishing-a-development-branch` is unavailable, stop the process and prompt to install or enable Superpowers skills. Do not substitute this step with normal conversation.
 

package/assets/skills-zh/opensuper/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper
 description: "OpenSuper — OpenSpec + Superpowers 双星开发流程。用 /opensuper 启动，自动检测阶段并分发到子命令。五阶段：开启 → 深度设计 → 计划与构建 → 验证与收尾 → 归档。"
 ---
 
-# OpenSuper — OpenSpec + Superpowers 双星开发流程
-
-OpenSpec 与 Superpowers 如双星系统围绕同一目标运转。
+# OpenSuper — OpenSpec + Superpowers 双星开发流程
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+OpenSpec 与 Superpowers 如双星系统围绕同一目标运转。
 
 ```
 OpenSpec 负责 WHAT  — 大纲、提案、spec 生命周期、归档

package/assets/skills-zh/opensuper-archive/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-archive
 description: "OpenSuper 阶段 5：归档。用 /opensuper-archive 调用。同步 delta spec 到主 spec，归档 change。"
 ---
 
-# OpenSuper 阶段 5：归档（Archive）
-
-## 前置条件
+# OpenSuper 阶段 5：归档（Archive）
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+## 前置条件
 
 - 验证已通过（阶段 4 完成）
 - 分支已处理

package/assets/skills-zh/opensuper-build/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-build
 description: "OpenSuper 阶段 3：计划与构建。用 /opensuper-build 调用。制定计划并选择执行方式（subagent 或直接执行）实施。"
 ---
 
-# OpenSuper 阶段 3：计划与构建（Build）
-
-## 前置条件
+# OpenSuper 阶段 3：计划与构建（Build）
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+## 前置条件
 
 - Design Doc 已创建（阶段 2 完成）
 - 活跃 change 存在
@@ -27,11 +34,12 @@ bash "$OPENSUPER_STATE" check <name> build
 
 ### 1. 制定计划
 
-**立即执行：** 使用 Skill 工具加载 `superpowers:writing-plans` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引制定计划。计划要求：
-- 保存至 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
-- 引用设计文档，拆分为可执行任务
+**立即执行：** 使用 Skill 工具加载 `superpowers:writing-plans` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+技能加载后，按其指引制定计划。计划要求：
+- 保存至 `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`
+- 引用设计文档，拆分为可执行任务
+- Plan 正文必须使用中文；frontmatter key、路径、命令和代码标识符保持原文
 - **Plan 文件头必须包含关联元数据**：
 
 ```yaml
@@ -125,9 +133,9 @@ bash "$OPENSUPER_STATE" set <name> build_mode direct
 
 没有 `direct_override: true` 时，full workflow 的 `build_mode=direct` 会被 guard 和状态转换同时拦截。
 
-然后，**立即执行：** 使用 Skill 工具加载对应技能。禁止跳过此步骤。
-
-如所选 Superpowers 技能不可用，停止流程并提示安装或启用对应技能，不要用普通对话替代该步骤。
+然后，**立即执行：** 使用 Skill 工具加载对应技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+如所选 Superpowers 技能不可用，停止流程并提示安装或启用对应技能，不要用普通对话替代该步骤。
 
 技能加载后，按其指引执行：
 - 按计划执行任务

package/assets/skills-zh/opensuper-design/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-design
 description: "OpenSuper 阶段 2：深度设计。用 /opensuper-design 调用。通过 brainstorming 产出 Design Doc 和 delta spec。"
 ---
 
-# OpenSuper 阶段 2：深度设计（Design）
-
-## 前置条件
+# OpenSuper 阶段 2：深度设计（Design）
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+## 前置条件
 
 - 活跃 change 已存在（proposal.md、design.md、tasks.md）
 - 无 Design Doc（`docs/superpowers/specs/` 下无对应文件）
@@ -36,11 +43,13 @@ bash "$OPENSUPER_STATE" check <name> design
 **立即执行：** 使用 Skill 工具加载 `superpowers:brainstorming` 技能，ARGUMENTS 包含：
 
 ```
-Change: <change-name>
-Proposal 摘要: <proposal 核心内容>
-Design 摘要: <design.md 架构决策>
-跳过上下文探索，直接进入设计提问。
-```
+Change: <change-name>
+产出语言：中文
+Proposal 摘要: <proposal 核心内容>
+Design 摘要: <design.md 架构决策>
+跳过上下文探索，直接进入设计提问。
+生成的 Design Doc、delta spec、讨论摘要和后续任务正文必须使用中文；命令、路径、frontmatter key、代码标识符保持原文。
+```
 
 禁止跳过此步骤，禁止在未加载该技能的情况下继续。
 

package/assets/skills-zh/opensuper-hotfix/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-hotfix
 description: "OpenSuper 预设路径：Bug fix / 热修复。跳过 brainstorming，直接 open → build → verify → archive。适用于行为修复、不涉及新 capability 设计的场景。"
 ---
 
-# OpenSuper 预设路径：Hotfix
-
-快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan，适用于行为修复、不涉及新 capability 设计的场景。
+# OpenSuper 预设路径：Hotfix
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+快速 bug fix 工作流：open → build → verify → archive。跳过 brainstorming 和完整 plan，适用于行为修复、不涉及新 capability 设计的场景。
 
 **适用条件**（必须全部满足）：
 1. 修复已有功能的 bug，不新增 capability
@@ -33,9 +40,9 @@ OPENSUPER_ARCHIVE="${OPENSUPER_ARCHIVE:-$(find "${OPENSUPER_SEARCH_ROOTS[@]}" -p
 
 复用 OpenSuper open 能力创建 change，但使用 hotfix 默认值：不执行 `openspec-explore` 长探索，直接进入精简 change 创建。
 
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引创建精简版产物：
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+技能加载后，按其指引创建精简版产物：
   - `proposal.md` — 问题描述 + 根因分析 + 修复目标（无需方案对比）
   - `design.md` — 修复方案（1 个即可，无需多方案对比）
   - `tasks.md` — 修复任务清单

package/assets/skills-zh/opensuper-open/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-open
 description: "OpenSuper 阶段 1：开启。用 /opensuper-open 调用。通过 OpenSpec 探索想法、创建 change 结构（proposal + design + tasks）。"
 ---
 
-# OpenSuper 阶段 1：开启（Open）
-
-## 前置条件
+# OpenSuper 阶段 1：开启（Open）
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+## 前置条件
 
 - 无活跃 change，或用户希望创建新 change
 
@@ -13,13 +20,15 @@ description: "OpenSuper 阶段 1：开启。用 /opensuper-open 调用。通过
 
 ### 1. 探索想法
 
-**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引自由探索问题空间。
+**立即执行：** 使用 Skill 工具加载 `openspec-explore` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+技能加载后，按其指引自由探索问题空间。探索结论、问题拆解和候选方案正文必须使用中文。
 
 ### 2. 创建 Change 结构 + 初始化状态
 
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。若用户意图未明确、需要先形成建议，改为加载 `openspec-propose`。禁止跳过此步骤。
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能，并传入要求：`产出语言：中文`。若用户意图未明确、需要先形成建议，改为加载 `openspec-propose`，同样传入中文产出要求。禁止跳过此步骤。
+
+创建的 `proposal.md`、`design.md`、`tasks.md` 正文必须使用中文；命令、路径、字段名、代码标识符保持原文。
 
 确认以下产物已创建：
 

package/assets/skills-zh/opensuper-tweak/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-tweak
 description: "OpenSuper 预设路径：非 bug 的小改动（tweak）。跳过 brainstorming 和完整 plan，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。"
 ---
 
-# OpenSuper 预设路径：Tweak
-
-Tweak 是 OpenSuper 五阶段能力的预设工作流，不是独立的平行流程。它复用 open、build、verify、archive 能力，仅跳过 brainstorming 和完整 plan。
+# OpenSuper 预设路径：Tweak
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+Tweak 是 OpenSuper 五阶段能力的预设工作流，不是独立的平行流程。它复用 open、build、verify、archive 能力，仅跳过 brainstorming 和完整 plan。
 
 适用于非 bug 的小范围变更，例如文案调整、配置调整、文档或 prompt 的局部优化。
 
@@ -36,9 +43,9 @@ OPENSUPER_ARCHIVE="${OPENSUPER_ARCHIVE:-$(find "${OPENSUPER_SEARCH_ROOTS[@]}" -p
 
 复用 OpenSuper open 能力创建 change，但使用 tweak 默认值：不执行 `openspec-explore` 长探索，直接进入精简 change 创建。
 
-**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引创建精简版产物：
+**立即执行：** 使用 Skill 工具加载 `openspec-new-change` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+技能加载后，按其指引创建精简版产物：
   - `proposal.md` — 变更动机 + 目标 + 范围
   - `design.md` — 简短实现说明（无需方案对比）
   - `tasks.md` — 不超过 3 个任务

package/assets/skills-zh/opensuper-verify/SKILL.md

@@ -3,9 +3,16 @@ name: opensuper-verify
 description: "OpenSuper 阶段 4：验证与收尾。用 /opensuper-verify 调用。验证实现符合设计，处理开发分支。"
 ---
 
-# OpenSuper 阶段 4：验证与收尾（Verify）
-
-## 前置条件
+# OpenSuper 阶段 4：验证与收尾（Verify）
+
+## 产出语言契约
+
+- 产出语言：中文。
+- 本 skill 的所有面向用户输出和生成文档默认使用中文，包括 `proposal.md`、`design.md`、`tasks.md`、delta spec、Design Doc、Plan、verification report 和归档说明。
+- 命令、路径、frontmatter key、代码标识符、包名和 API 名称保持原文。
+- 只有用户明确要求英文时才改用英文正文。
+
+## 前置条件
 
 - 代码已提交（阶段 3 完成）
 - tasks.md 全部任务已完成
@@ -79,9 +86,9 @@ bash "$OPENSUPER_STATE" transition <name> verify-fail
 
 当规模评估结果为"大"时：
 
-**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能。禁止跳过此步骤。
-
-技能加载后，按其指引验证。检查项：
+**立即执行：** 使用 Skill 工具加载 `openspec-verify-change` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+技能加载后，按其指引验证。检查项：
 1. tasks.md 全部任务已完成（`[x]`）
 2. 实现符合 design.md 设计决策
 3. 实现符合 brainstorming 设计文档
@@ -104,9 +111,9 @@ bash "$OPENSUPER_STATE" transition <name> verify-fail
 
 ### 3. 收尾（Superpowers）
 
-**立即执行：** 使用 Skill 工具加载 `superpowers:finishing-a-development-branch` 技能。禁止跳过此步骤。
-
-如 `superpowers:finishing-a-development-branch` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
+**立即执行：** 使用 Skill 工具加载 `superpowers:finishing-a-development-branch` 技能，并传入要求：`产出语言：中文`。禁止跳过此步骤。
+
+如 `superpowers:finishing-a-development-branch` 不可用，停止流程并提示安装或启用 Superpowers 技能，不要用普通对话替代该步骤。
 
 技能加载后，按其指引收尾。分支处理选项：
 1. 本地合并到主分支
@@ -120,7 +127,7 @@ bash "$OPENSUPER_STATE" transition <name> verify-fail
 
 ### 4. 记录验证证据
 
-验证报告必须落盘，并在 `.opensuper.yaml` 中记录；分支处理完成后也必须写入状态字段。不要手动设置 `verify_result: pass`，通过 guard 自动流转。
+验证报告必须落盘，并在 `.opensuper.yaml` 中记录；分支处理完成后也必须写入状态字段。验证报告正文必须使用中文。不要手动设置 `verify_result: pass`，通过 guard 自动流转。
 
 ```bash
 mkdir -p docs/superpowers/reports

package/package.json

@@ -1,62 +1,59 @@
-{
-  "name": "@pzy560117/opensuper",
-  "version": "0.2.7",
-  "description": "OpenSpec + Superpowers dual-star development workflow",
-  "keywords": [
-    "opensuper",
-    "openspec",
-    "superpowers",
-    "skills",
-    "workflow"
-  ],
-  "license": "MIT",
-  "author": "benym",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "opensuper": "bin/opensuper.js"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "assets",
-    "scripts/postinstall.js",
-    "!dist/**/*.test.js",
-    "!dist/**/__tests__"
-  ],
-  "scripts": {
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write src/",
-    "format:check": "prettier --check src/",
-    "test:shell": "node scripts/run-bats.js test/shell/*.bats",
-    "prepare": "pnpm run build",
-    "prepublishOnly": "node scripts/prepublish-check.js && pnpm run build",
-    "postinstall": "node scripts/postinstall.js"
-  },
-  "packageManager": "pnpm@10.18.3",
-  "engines": {
-    "node": ">=20"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@types/node": "^24.2.0",
-    "@vitest/coverage-v8": "^4.1.6",
-    "eslint": "^10.4.0",
-    "prettier": "^3.8.3",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.59.3",
-    "vitest": "^4.1.6"
-  },
-  "dependencies": {
-    "@inquirer/prompts": "^8.4.3",
-    "commander": "^14.0.0"
-  }
-}
+{
+  "name": "@pzy560117/opensuper",
+  "version": "0.2.8",
+  "description": "OpenSpec + Superpowers dual-star development workflow",
+  "keywords": [
+    "opensuper",
+    "openspec",
+    "superpowers",
+    "skills",
+    "workflow"
+  ],
+  "license": "MIT",
+  "author": "benym",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "opensuper": "bin/opensuper.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "assets",
+    "scripts/postinstall.js",
+    "!dist/**/*.test.js",
+    "!dist/**/__tests__"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.2.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "eslint": "^10.4.0",
+    "prettier": "^3.8.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.3",
+    "vitest": "^4.1.6"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.4.3",
+    "commander": "^14.0.0"
+  },
+  "scripts": {
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "test:shell": "node scripts/run-bats.js test/shell/*.bats",
+    "postinstall": "node scripts/postinstall.js"
+  }
+}