@chenmk/superflow 0.1.0 → 0.1.2

package/INSTALL.en.md

@@ -2,8 +2,9 @@
 
 [中文教程](./INSTALL.md)
 
-SuperBridge Flow installs OpenSpec, Superpowers, skills, hooks, scripts, rules,
-and handoff state for Claude Code and Codex.
+SuperBridge Flow installs OpenSpec, Superpowers, skills, hooks or command
+aliases, scripts, rules, and handoff state for Claude Code, Codex, and
+OpenCode.
 
 ## 1. Install
 
@@ -24,18 +25,27 @@ superflow init --language en --yes
 superflow init --language zh --yes
 ```
 
+Global language selection is also supported:
+
+```bash
+superflow --language en --help
+SUPERFLOW_LANG=en superflow init
+```
+
 `superflow init` performs:
 
 1. Detect platform paths.
 2. Install OpenSpec CLI.
-3. Run native `openspec init <project> --tools claude,codex --profile custom`.
-4. Install Superpowers for selected agents.
+3. Run native `openspec init <project> --tools ... --profile custom`.
+4. Install Superpowers for selected Claude Code/Codex agents.
 5. Try understand-anything and api-doc-changelog.
 6. Deploy SuperBridge Flow/OpenSpec skills.
 7. Register hooks and rules.
 8. Scaffold `docs/sdd-context/`.
 
-OpenSpec and Superpowers are required. understand-anything is best-effort.
+OpenSpec and Superpowers are required for the full workflow. OpenCode receives
+skills and command aliases; native hook registration is not enabled for
+OpenCode yet. understand-anything is best-effort.
 
 ## 3. Daily Workflow
 
@@ -51,6 +61,12 @@ In Claude Code:
 /superflow-pipeline
 ```
 
+In OpenCode:
+
+```text
+/superflow-pipeline
+```
+
 The workflow phases are:
 
 ```text
@@ -70,6 +86,16 @@ superflow doctor
 was compressed or interrupted, ask the agent to continue the current SuperBridge
 Flow change. It will read `.sdd/state.yaml` and `.sdd/handoff`.
 
+To regenerate project context templates:
+
+```bash
+superflow scan --language en
+superflow scan --language en --force
+```
+
+`scan` keeps edited files by default. Use `--force` only when you want to
+overwrite the four files under `docs/sdd-context/`.
+
 ## 5. Updates
 
 Refresh installed skills, hooks, scripts, and rules:
@@ -100,6 +126,7 @@ Team environments should keep `check`. Personal machines may choose `apply`.
 ```bash
 superflow uninstall --agent codex --force
 superflow uninstall --agent claude --force
+superflow uninstall --agent opencode --force
 ```
 
 This removes SuperBridge Flow managed assets only. It does not remove unrelated

package/INSTALL.md

@@ -1,6 +1,6 @@
 # SuperBridge Flow 安装、初始化与日常使用教程
 
-`@chenmk/superflow` 是面向 Claude Code 和 Codex 的 SDD 开发工作流 CLI。它把
+`@chenmk/superflow` 是面向 Claude Code、Codex 和 OpenCode 的 SDD 开发工作流 CLI。它把
 OpenSpec、Superpowers、SuperBridge Flow 技能、状态机、handoff 上下文包、hook 脚本和
 质量门禁安装到你的 agent 环境里，让一个需求可以沿着固定阶段推进：
 
@@ -24,7 +24,7 @@ docs -> design -> implement -> verify -> archive
 | Node.js | 20+ | `node -v` |
 | npm | 9+ | `npm -v` |
 | Git | 已安装 | `git --version` |
-| Agent | Claude Code 或 Codex 至少一个 | `claude --version` / `codex --version` |
+| Agent | Claude Code、Codex 或 OpenCode 至少一个 | `claude --version` / `codex --version` / `opencode --version` |
 | Shell | macOS/Linux 原生 shell；Windows 使用 Git Bash 或兼容 shell | `bash --version` |
 | Python | hook 中的 Python 脚本需要 | `python3 --version` |
 
@@ -55,7 +55,7 @@ npm install -g @chenmk/superflow
 
 ```bash
 git clone <your-repo-url>
-cd code-cli-config/sdd-cli
+cd superflow
 npm install
 npm run build
 npm install -g .
@@ -83,7 +83,8 @@ cd your-project
 superflow init
 ```
 
-CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code，或两者都选。
+CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code、只选 OpenCode，
+也可以选择多个工具。
 选择结果会替代手写 `--agent codex` / `--agent claude`。
 
 `superflow init` 会执行：
@@ -92,13 +93,14 @@ CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code，
 2. 安装 OpenSpec CLI。
 3. 在当前项目目录执行 OpenSpec 原生初始化，并把你选择的工具下发给
    OpenSpec，例如 `openspec init <project> --tools claude,codex --profile custom`。
-4. 为目标 agent 安装 Superpowers；这是 Superflow 的核心 HOW/TDD 依赖，
-   安装失败会中断初始化。
+4. 为 Claude Code / Codex 安装 Superpowers；这是 Superflow 的核心 HOW/TDD
+   依赖，安装失败会中断初始化。OpenCode 侧会部署 SuperBridge Flow skills
+   和 commands，不注册原生 hook。
 5. 尝试安装 understand-anything，并复制 api-doc-changelog；失败只警告，
    不阻断初始化。
 6. 部署 SuperBridge Flow/OpenSpec skills。
-7. 部署 hook 脚本并注册到 Codex `hooks.json` 或 Claude
-   `settings.json`。
+7. 部署 hook/command 脚本；Codex 写入 `hooks.json`，Claude Code 写入
+   `settings.json`，OpenCode 写入 `.opencode/commands`。
 8. 部署 SuperBridge Flow 防漂移规则。
 9. 初始化 `docs/sdd-context/` 项目上下文模板，并提示
    understand-anything 扫描状态。
@@ -109,8 +111,9 @@ CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code，
 请选择要初始化的 agent 工具（可多选）：
   1) Claude Code
   2) Codex
-  a) 两者都安装（默认）
-输入序号，例如 1,2 / 2 / a：
+  3) OpenCode
+  a) 安装 Claude Code + Codex（默认）；输入 all 会包含 OpenCode
+输入序号，例如 1,2 / 2,3 / all / a：
 ```
 
 选择结果会同时影响：
@@ -125,8 +128,10 @@ CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code，
 
 | 命令 | 说明 |
 |------|------|
-| `superflow init` | 交互式初始化，可多选 Codex / Claude Code |
+| `superflow init` | 交互式初始化，可多选 Codex / Claude Code / OpenCode |
 | `superflow init --yes` | 非交互执行，默认初始化 Claude Code + Codex |
+| `superflow init --agent opencode` | 只初始化 OpenCode |
+| `superflow init --agent all` | 初始化 Claude Code + Codex + OpenCode |
 | `superflow init --scope global` | 安装到用户主目录，默认值 |
 | `superflow init --scope project` | 安装到当前项目目录 |
 | `superflow init --no-hooks` | 只安装技能和脚本，不注册 hook |
@@ -138,13 +143,36 @@ CLI 会弹出工具选择列表。你可以只选 Codex、只选 Claude Code，
 | `superflow init --overwrite` | 覆盖已安装的 SuperBridge Flow 技能 |
 | `superflow init --skip-existing` | 保留已存在技能，不覆盖 |
 
-初始化后建议重启 Claude Code 或 Codex，让 agent 重新加载技能列表。
+语言可以通过两种方式选择：
+
+```bash
+# 单次命令使用英文 help / 提示
+superflow --language en --help
+superflow init --language en
+
+# 当前 shell 默认使用英文提示
+export SUPERFLOW_LANG=en
+superflow init
+```
+
+如果只想重新生成项目上下文模板，可以使用：
+
+```bash
+superflow scan --language zh
+superflow scan --language en --force
+```
+
+`scan` 默认保留已经编辑过的文件；加 `--force` 才会覆盖
+`docs/sdd-context/` 下的 4 个模板文件。
+
+初始化后建议重启 Claude Code、Codex 或 OpenCode，让 agent 重新加载技能列表。
 
 ## 4. 验证安装
 
 ```bash
 superflow doctor --agent codex
 superflow doctor --agent claude
+superflow doctor --agent opencode
 ```
 
 也可以同时检查两侧：
@@ -160,7 +188,7 @@ superflow doctor
 - Superpowers、understand-anything、api-doc-changelog 是否可检测。
 - SuperBridge Flow skills 是否完整。
 - hook 脚本是否存在。
-- hook 是否已注册。
+- hook 是否已注册；OpenCode 当前检查 command alias，不把原生 hook 作为硬门禁。
 - SDD rule 是否已部署。
 - 当前项目里的 `.sdd/state.yaml` 是否符合状态机字段约束。
 
@@ -168,6 +196,7 @@ superflow doctor
 
 ```bash
 superflow pipeline --agent codex
+superflow pipeline --agent opencode
 superflow docs --agent codex
 superflow design --agent codex
 superflow implement --agent codex
@@ -179,18 +208,21 @@ superflow archive --agent codex
 
 ### 5.1 开始一个完整需求
 
-Codex 和 Claude Code 的触发方式不同：
+Codex、Claude Code 和 OpenCode 的触发方式不同：
 
 - Codex：通常用自然语言或 `$skill-name` 触发，例如“请使用 SuperBridge Flow 流程”或
   `$superflow-pipeline`。
 - Claude Code：安装后可以直接使用 slash command，例如
   `/superflow-pipeline`、`/superflow-clarify`、`/superflow-docs`、`/superflow-design`、
   `/superflow-implement`、`/superflow-verify`、`/superflow-archive`。
+- OpenCode：安装后使用 `.opencode/commands` 里的 slash command，例如
+  `/superflow-pipeline`、`/superflow-docs`、`/superflow-design`、`/superflow-verify`。
 
 普通使用建议始终先走总路由，让 SDD 自己判断阶段：
 
 - Codex：优先 `$superflow-pipeline` 或自然语言“请使用 SuperBridge Flow 流程”。
 - Claude Code：优先 `/superflow-pipeline`。
+- OpenCode：优先 `/superflow-pipeline`。
 
 只有你非常明确当前就是需求澄清、文档补齐、技术详设或实现阶段时，才直达
 `$superflow-clarify` / `/superflow-clarify`、`$superflow-docs` / `/superflow-docs` 等阶段命令。
@@ -207,6 +239,12 @@ Codex 和 Claude Code 的触发方式不同：
 /superflow-pipeline 处理这个需求：……
 ```
 
+在 OpenCode 会话里同样可以运行：
+
+```text
+/superflow-pipeline 处理这个需求：……
+```
+
 两种方式都会从 SDD 总入口路由，通常按下面阶段推进。
 
 #### 示例：读取飞书在线文档中的某个小节
@@ -453,7 +491,7 @@ Claude Code 里也可以直接用当前阶段命令继续，例如：
 
 - `@chenmk/superflow`
 - `@fission-ai/openspec`
-- Claude Code / Codex 的 Superpowers 插件
+- Claude Code / Codex 的 Superpowers 插件；OpenCode 侧刷新 SuperBridge Flow assets
 
 同一会话只检查一次；默认只提示，不自动安装。至少间隔 6 小时才真正访问
 npm/plugin 源，避免每次 prompt 都联网。可用：
@@ -538,7 +576,7 @@ which superflow
 如果是源码安装，也可以重新链接：
 
 ```bash
-cd code-cli-config/sdd-cli
+cd superflow
 npm run build
 npm install -g .
 ```
@@ -561,17 +599,20 @@ python3 --version
 
 ### 技能装好了，但 agent 没触发
 
-重启 Claude Code 或 Codex。若仍不触发：
+重启 Claude Code、Codex 或 OpenCode。若仍不触发：
 
 ```bash
 superflow doctor --agent codex
+superflow doctor --agent opencode
 superflow pipeline --agent codex
+superflow pipeline --agent opencode
 ```
 
 然后在会话里明确说：
 
 ```text
 请使用 $superflow-pipeline 处理这个需求。
+/superflow-pipeline 处理这个需求。
 ```
 
 ### 任务 prompt 偶发缺失

package/README.md

@@ -1,18 +1,66 @@
-# SuperBridge Flow
+<p align="center">
+  <img src="./assets/brand/superflow-banner.svg" alt="SuperBridge Flow banner">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="npm version" src="https://img.shields.io/npm/v/@chenmk/superflow?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="monthly downloads" src="https://img.shields.io/npm/dm/@chenmk/superflow?style=flat-square&label=Downloads/mo"></a>
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="weekly downloads" src="https://img.shields.io/npm/dw/@chenmk/superflow?style=flat-square&label=Downloads/wk"></a>
+  <a href="https://github.com/BasketballNotFound-ManKun/superflow-cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/BasketballNotFound-ManKun/superflow-cli?style=flat-square"></a>
+  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square"></a>
+  <img alt="Node.js 20+" src="https://img.shields.io/badge/Node.js-20%2B-339933?style=flat-square">
+</p>
+
+<p align="center">
+  <strong>A workflow harness for turning OpenSpec/SDD contracts and
+  Superpowers engineering discipline into one delivery flow.</strong>
+</p>
+
+<p align="center">
+  <a href="./README.zh-CN.md">中文文档</a>
+  ·
+  <a href="#install">Install</a>
+  ·
+  <a href="#workflow">Workflow</a>
+  ·
+  <a href="#star-history">Star History</a>
+</p>
 
-[中文文档](./README.zh-CN.md)
+# SuperBridge Flow
 
 SuperBridge Flow is a workflow CLI for bringing OpenSpec/SDD and Superpowers
 together in real software delivery.
 
+## Why SuperBridge Flow
+
+Modern agentic coding often fails in the gap between a well-written spec and
+real verified delivery. SuperBridge Flow makes that gap explicit:
+
 - OpenSpec/SDD owns **WHAT**: requirements, API contracts, database and field
   semantics, tests, real-entry acceptance, and quality gates.
 - Superpowers owns source-level **HOW**: technical design, TDD order,
   worktree/team execution, review, and verification discipline.
-- The full lifecycle is `docs -> design -> implement -> verify -> archive`.
+- Handoff files, phase state, hooks, and guards reduce context drift when long
+  conversations get compacted or split across agent sessions.
+
+The CLI installs skills, hooks or command aliases, rules, scripts, handoff
+state, and dependency guards for Claude Code, Codex, and OpenCode.
+
+## Workflow
 
-The CLI installs skills, hooks, rules, scripts, handoff state, and dependency
-guards for Claude Code and Codex.
+```text
+docs -> design -> implement -> verify -> archive
+```
+
+Each phase has a clear owner and an exit gate:
+
+| Phase | Owner | Output |
+| --- | --- | --- |
+| `docs` | OpenSpec/SDD | Requirements, contracts, API/DB/test docs |
+| `design` | Superpowers | Source-level technical design and TDD plan |
+| `implement` | Superpowers + SuperBridge Flow | Batched implementation prompts and review gates |
+| `verify` | SuperBridge Flow hooks | Evidence-backed test report and real-entry checks |
+| `archive` | OpenSpec/SDD | Final spec archive and lifecycle closure |
 
 ## Install
 
@@ -28,7 +76,7 @@ superflow init
 
 Interactive init lets you select:
 
-- target agent tools: Claude Code, Codex, or both
+- target agent tools: Claude Code, Codex, OpenCode, or selected combinations
 - language: English or Chinese
 - install scope: global or project
 
@@ -40,6 +88,13 @@ superflow init --language en --yes
 superflow init --language zh --yes
 ```
 
+CLI help and runtime prompts can also be switched globally:
+
+```bash
+superflow --language en --help
+SUPERFLOW_LANG=en superflow init
+```
+
 ## What Init Installs
 
 `superflow init` installs and configures:
@@ -60,10 +115,14 @@ best-effort and does not block initialization.
 | Command | Purpose |
 | --- | --- |
 | `superflow init` | Install and configure SuperBridge Flow interactively |
+| `superflow init --agent opencode` | Install OpenCode skills and command aliases |
+| `superflow init --agent all` | Install Claude Code, Codex, and OpenCode |
 | `superflow update` | Refresh installed skills, hooks, scripts, and rules |
 | `superflow update --with-package` | Also update `@chenmk/superflow`, OpenSpec, and Superpowers |
 | `superflow doctor` | Diagnose installed assets and project state |
 | `superflow status` | Show active changes, current phase, next command, and risks |
+| `superflow --language en --help` | Show English CLI help |
+| `superflow scan --language en` | Regenerate project context templates in English |
 | `superflow pipeline` | Check pipeline skill deployment |
 | `superflow docs` | Check docs-phase skill deployment |
 | `superflow design` | Check design-phase skill deployment |
@@ -85,6 +144,16 @@ In Claude Code:
 /superflow-pipeline
 ```
 
+In OpenCode:
+
+```text
+/superflow-pipeline
+```
+
+OpenCode receives `.opencode/skills` and `.opencode/commands` assets. Native
+hook registration is not enabled for OpenCode yet; use `/superflow-*` commands
+to run workflow gates explicitly.
+
 For large requirements, ask the agent to read one section or one feature at a
 time. SuperBridge Flow will route through clarification, OpenSpec docs,
 Superpowers technical design, implementation prompts, verification, and archive.
@@ -133,10 +202,17 @@ keeps the same workflow contracts.
 ## Requirements
 
 - Node.js 20+
-- Claude Code or Codex
+- Claude Code, Codex, or OpenCode
 - npm access to install OpenSpec and Superpowers
 - Git Bash or a compatible shell on Windows for hook scripts
 
+## Star History
+
+The chart is generated by Star History from public GitHub star data. It may stay
+empty while the repository is private.
+
+[![Star History Chart](https://api.star-history.com/svg?repos=BasketballNotFound-ManKun/superflow-cli&type=Date)](https://star-history.com/#BasketballNotFound-ManKun/superflow-cli&Date)
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -1,13 +1,59 @@
+<p align="center">
+  <img src="./assets/brand/superflow-banner.svg" alt="SuperBridge Flow banner">
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="npm version" src="https://img.shields.io/npm/v/@chenmk/superflow?style=flat-square"></a>
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="monthly downloads" src="https://img.shields.io/npm/dm/@chenmk/superflow?style=flat-square&label=Downloads/mo"></a>
+  <a href="https://www.npmjs.com/package/@chenmk/superflow"><img alt="weekly downloads" src="https://img.shields.io/npm/dw/@chenmk/superflow?style=flat-square&label=Downloads/wk"></a>
+  <a href="https://github.com/BasketballNotFound-ManKun/superflow-cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/BasketballNotFound-ManKun/superflow-cli?style=flat-square"></a>
+  <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square"></a>
+  <img alt="Node.js 20+" src="https://img.shields.io/badge/Node.js-20%2B-339933?style=flat-square">
+</p>
+
+<p align="center">
+  <strong>把 OpenSpec/SDD 的合同约束和 Superpowers 的工程纪律，收束成一个可执行的交付工作流。</strong>
+</p>
+
+<p align="center">
+  <a href="./README.md">English</a>
+  ·
+  <a href="#安装">安装</a>
+  ·
+  <a href="#工作流">工作流</a>
+  ·
+  <a href="#star-history">Star History</a>
+</p>
+
 # SuperBridge Flow
 
-[English](./README.md)
+通用 SDD 开发工作流 CLI，支持 Claude Code、Codex 和 OpenCode。
 
-通用 SDD 开发工作流 CLI，支持 Claude Code 和 Codex。
+SuperBridge Flow 不是简单“装两个工具”，而是把 OpenSpec/SDD 和
+Superpowers 编排成一个有状态的研发流程：前者负责需求、合同和验收口径，
+后者负责源码级设计、TDD 顺序、实现分工、review 和真实验证。
 
-把 SuperBridge Flow 技能和配套 hook 脚本整合为单一 npm 包，通过 CLI 自动部署到：
+CLI 会把 SuperBridge Flow 技能、配套 hook/command 脚本整合为单一 npm 包，
+自动部署到：
 
 - Claude Code：`~/.claude/skills/`、`~/.claude/scripts/`，并注册 `~/.claude/settings.json` hook
 - Codex：`~/.codex/skills/`、`~/.codex/hooks/`
+- OpenCode：`.opencode/skills/`、`.opencode/commands/`、`.opencode/scripts/`
+  或全局 `~/.config/opencode/`
+
+## 工作流
+
+```text
+docs -> design -> implement -> verify -> archive
+```
+
+| 阶段 | 主责 | 产物 |
+|------|------|------|
+| `docs` | OpenSpec/SDD | 需求、接口、数据库、测试和验收合同 |
+| `design` | Superpowers | 源码级技术详设、影响面分析和 TDD 计划 |
+| `implement` | Superpowers + SuperBridge Flow | 分批任务 prompt、review 门禁和执行状态 |
+| `verify` | SuperBridge Flow hooks | 有证据的测试报告、真实入口和联调校验 |
+| `archive` | OpenSpec/SDD | 归档后的 spec 状态和生命周期闭环 |
 
 ## 安装
 
@@ -20,12 +66,18 @@ npm install -g @chenmk/superflow
 ## 快速开始
 
 ```bash
-# 交互式选择 Claude Code / Codex（可多选）
+# 交互式选择 Claude Code / Codex / OpenCode（可多选）
 superflow init
 
 # 非交互模式，默认同时安装 Claude Code + Codex
 superflow init --yes
 
+# 显式安装 OpenCode
+superflow init --agent opencode
+
+# 同时安装 Claude Code + Codex + OpenCode
+superflow init --agent all
+
 # 跳过 hook 注册（手工管理）
 superflow init --no-hooks
 
@@ -39,6 +91,17 @@ superflow init --resume
 superflow doctor
 ```
 
+语言也可以全局切换：
+
+```bash
+# 查看英文 CLI help
+superflow --language en --help
+
+# 当前 shell 默认使用英文提示
+export SUPERFLOW_LANG=en
+superflow init
+```
+
 ## SDD 分工
 
 - OpenSpec/SDD 负责 WHAT 和合同：需求、API、DB、SQL、字段语义、tests、真实入口验收和质量门禁。
@@ -51,14 +114,18 @@ superflow doctor
 
 | 命令 | 说明 |
 |------|------|
-| `superflow init` | 一站式安装；交互终端中可多选 Claude Code / Codex |
+| `superflow init` | 一站式安装；交互终端中可多选 Claude Code / Codex / OpenCode |
 | `superflow init --yes` | 非交互安装，默认 `--agent both` |
+| `superflow init --agent opencode` | 安装 OpenCode skills、commands、scripts 和 rules |
+| `superflow init --agent all` | 同时安装 Claude Code + Codex + OpenCode |
 | `superflow init --dry-run` | 只打印计划不执行 |
 | `superflow init --resume` | 从失败步骤继续 |
 | `superflow init --no-hooks` | 只装技能 + 脚本，跳过 Codex/Claude hook 注册 |
 | `superflow init --no-openspec-init` | 跳过当前项目 OpenSpec 原生初始化 |
 | `superflow doctor` | 诊断 CLI / 第三方 / 脚本 / skills |
 | `superflow doctor --agent codex` | 只诊断 Codex 侧 |
+| `superflow --language en --help` | 查看英文 CLI help |
+| `superflow scan --language en` | 重新生成英文项目上下文模板 |
 | `superflow clarify [feature]` | 校验 SuperBridge Flow clarify 阶段技能部署 |
 | `superflow docs [change]` | 校验 SuperBridge Flow docs 阶段技能部署 |
 | `superflow design [change]` | 校验 SuperBridge Flow design 阶段技能部署 |
@@ -74,10 +141,10 @@ superflow doctor
 ## 依赖
 
 - Node.js 20+
-- Claude Code 或 Codex（按 `--agent` 选择）
+- Claude Code、Codex 或 OpenCode（按 `--agent` 选择）
 - 第三方（`superflow init` 自动装）：
   - openspec CLI（硬依赖，npm 全局）并在当前项目执行 `openspec init --tools ...`
-  - superpowers（硬依赖，Claude Code / Codex 对应插件）
+  - superpowers（Claude Code / Codex 为硬依赖；OpenCode 侧通过已部署 skills/commands 使用流程）
   - understand-anything（尽力安装，失败只警告）
   - api-doc-changelog（辅助 skill，复制到目标 agent skills 目录）
 
@@ -87,7 +154,7 @@ superflow doctor
 
 - `@chenmk/superflow`
 - `@fission-ai/openspec`
-- Claude Code / Codex 的 Superpowers 插件
+- Claude Code / Codex 的 Superpowers 插件；OpenCode 侧的 SuperBridge Flow assets
 
 推荐策略是“自动检查，手动更新”：默认只提示，不自动安装；执行
 `superflow update --with-package` 才会统一更新。
@@ -107,10 +174,12 @@ export SUPERFLOW_AUTO_UPDATE=apply
 export SUPERFLOW_UPDATE_MIN_INTERVAL_SECONDS=21600
 ```
 
-## 设计文档
+## Star History
+
+下图由 Star History 根据 GitHub 公开 star 数据动态生成。仓库保持 private
+时，第三方服务通常读不到完整数据；切换为 public 后会正常展示趋势。
 
-- 详细设计：`~/cmk-project/code-cli-config/sdd-cli-design.md`
-- 实施 plan：`~/cmk-project/code-cli-config/sdd-cli-plan.md`
+[![Star History Chart](https://api.star-history.com/svg?repos=BasketballNotFound-ManKun/superflow-cli&type=Date)](https://star-history.com/#BasketballNotFound-ManKun/superflow-cli&Date)
 
 ## 许可证
 

package/assets/brand/superflow-banner.svg

@@ -0,0 +1,80 @@
+<svg width="1600" height="420" viewBox="0 0 1600 420" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+  <title id="title">SuperBridge Flow banner</title>
+  <desc id="desc">A dark technical banner for SuperBridge Flow, connecting OpenSpec and Superpowers through a bridge-shaped workflow.</desc>
+  <defs>
+    <radialGradient id="blueGlow" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(328 205) rotate(18) scale(502 230)">
+      <stop stop-color="#67e8f9"/>
+      <stop offset="0.34" stop-color="#2563eb" stop-opacity="0.86"/>
+      <stop offset="1" stop-color="#020617" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="greenGlow" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(1110 218) rotate(160) scale(430 210)">
+      <stop stop-color="#22c55e" stop-opacity="0.9"/>
+      <stop offset="0.42" stop-color="#0891b2" stop-opacity="0.64"/>
+      <stop offset="1" stop-color="#020617" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="flow" x1="174" y1="256" x2="1360" y2="126" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#60a5fa"/>
+      <stop offset="0.46" stop-color="#a78bfa"/>
+      <stop offset="1" stop-color="#34d399"/>
+    </linearGradient>
+    <filter id="softGlow" x="-40%" y="-40%" width="180%" height="180%" color-interpolation-filters="sRGB">
+      <feGaussianBlur stdDeviation="10" result="blur"/>
+      <feColorMatrix in="blur" type="matrix" values="0 0 0 0 0.28 0 0 0 0 0.65 0 0 0 0 1 0 0 0 0.9 0"/>
+      <feBlend in="SourceGraphic" mode="screen"/>
+    </filter>
+    <pattern id="dotGrid" width="22" height="22" patternUnits="userSpaceOnUse">
+      <circle cx="2" cy="2" r="1.4" fill="#38bdf8" opacity="0.28"/>
+    </pattern>
+  </defs>
+
+  <rect width="1600" height="420" rx="18" fill="#020617"/>
+  <rect width="1600" height="420" rx="18" fill="url(#blueGlow)"/>
+  <rect width="1600" height="420" rx="18" fill="url(#greenGlow)"/>
+  <rect x="0" y="0" width="1600" height="420" fill="url(#dotGrid)" opacity="0.72"/>
+
+  <path d="M94 310C250 136 405 106 568 214C734 324 884 319 1039 181C1159 74 1298 56 1488 112" stroke="url(#flow)" stroke-width="8" stroke-linecap="round" filter="url(#softGlow)"/>
+  <path d="M122 338C298 210 438 205 584 282C743 365 936 308 1054 214C1184 111 1318 103 1476 154" stroke="#e0f2fe" stroke-width="2" stroke-linecap="round" opacity="0.78"/>
+  <path d="M126 282C298 68 513 80 664 196C808 307 966 273 1092 146C1214 23 1374 32 1502 72" stroke="#93c5fd" stroke-width="2" stroke-linecap="round" opacity="0.42"/>
+
+  <g opacity="0.86">
+    <path d="M280 304H1320" stroke="#64748b" stroke-width="2"/>
+    <path d="M360 304C430 218 500 178 570 178C650 178 710 304 790 304C875 304 935 178 1025 178C1100 178 1168 222 1240 304" stroke="#cbd5e1" stroke-width="5" stroke-linecap="round"/>
+    <path d="M422 304V252M528 304V207M635 304V207M742 304V252M858 304V252M965 304V207M1072 304V207M1178 304V252" stroke="#cbd5e1" stroke-width="5" stroke-linecap="round"/>
+  </g>
+
+  <g>
+    <rect x="94" y="84" width="230" height="52" rx="8" fill="#0f172a" stroke="#38bdf8" stroke-opacity="0.45"/>
+    <text x="118" y="118" fill="#bae6fd" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="24" letter-spacing="2">OpenSpec / SDD</text>
+    <rect x="94" y="148" width="230" height="40" rx="8" fill="#020617" stroke="#334155"/>
+    <text x="118" y="174" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="18">WHAT + contracts</text>
+  </g>
+
+  <g>
+    <rect x="1276" y="238" width="230" height="52" rx="8" fill="#052e2b" stroke="#34d399" stroke-opacity="0.52"/>
+    <text x="1300" y="272" fill="#bbf7d0" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="24" letter-spacing="2">Superpowers</text>
+    <rect x="1276" y="302" width="230" height="40" rx="8" fill="#020617" stroke="#334155"/>
+    <text x="1300" y="328" fill="#94a3b8" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="18">HOW + verification</text>
+  </g>
+
+  <g>
+    <text x="522" y="132" fill="#f8fafc" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="72" font-weight="800" letter-spacing="6">SUPERFLOW</text>
+    <text x="528" y="179" fill="#cbd5e1" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="28" letter-spacing="5">SUPERBRIDGE FLOW</text>
+    <text x="531" y="224" fill="#60a5fa" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="24" letter-spacing="3">FROM REQUIREMENT TO VERIFIED DELIVERY</text>
+  </g>
+
+  <g fill="#e2e8f0" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace" font-size="17" opacity="0.9">
+    <text x="506" y="355">docs</text>
+    <text x="638" y="355">design</text>
+    <text x="800" y="355">implement</text>
+    <text x="990" y="355">verify</text>
+    <text x="1136" y="355">archive</text>
+  </g>
+
+  <g fill="#38bdf8" filter="url(#softGlow)">
+    <circle cx="486" cy="304" r="7"/>
+    <circle cx="624" cy="304" r="7"/>
+    <circle cx="782" cy="304" r="7"/>
+    <circle cx="960" cy="304" r="7"/>
+    <circle cx="1118" cy="304" r="7"/>
+  </g>
+</svg>