openfuyao-powers

openFuyao-powers 为 openFuyao 社区提供 AI 辅助研发能力集，覆盖需求分析、方案设计、编码开发与集成测试等 openFuyao 社区软件研发全流程，并辅以 GitCode 平台迭代工作流 Skill。支持 Claude Code、Codex、OpenCode 等主流 AI 辅助开发工具。

安装与升级

访问令牌（GitCode）

如果使用 GitCode 相关能力，需要准备个人访问令牌；若已配置过可跳过。

1. 登录 GitCode。
2. 进入 个人设置 → 访问令牌，创建并妥善保存令牌。

多工具并存提示

若同时使用多款 AI 编程工具，请先确认各自插件目录是否独立、是否会交叉读取对方安装路径。避免出现多份副本、路径冲突或资源重复占用。

Claude Code

1. 编辑 ~/.claude/settings.json，在 env 中配置 GITCODE_TOKEN（若无 env 字段可自行添加）：

{
  "env": {
    "GITCODE_TOKEN": "your-personal-access-token"
  }
}

2. 添加 marketplace 并安装插件：

claude plugin marketplace add https://gitcode.com/openFuyao/openfuyao-powers.git
claude plugin install openfuyao-powers@openfuyao-powers-dev

3. 更新插件

claude plugin update openfuyao-powers@openfuyao-powers-dev

Cursor / Codex / OpenCode

执行一站式安装、更新脚本。

# bash
curl -fsSL https://raw.gitcode.com/openFuyao/openfuyao-powers/raw/master/scripts/install-plugin.sh | bash

# PowerShell 5.1 / 7+
irm https://raw.gitcode.com/openFuyao/openfuyao-powers/raw/master/scripts/install-plugin.ps1 | iex

多工具选择

脚本会检测 Cursor / Codex / OpenCode 存在性，并询问要为哪些工具安装。可通过 --targets 限定检测范围，若不指定则默认检测全部工具。

# 仅更新 Cursor 侧
curl -fsSL https://gitcode.com/openFuyao/openfuyao-powers/raw/master/scripts/install-plugin.sh | bash -s -- --targets cursor

# 同时更新 Codex 和 OpenCode
curl -fsSL https://gitcode.com/openFuyao/openfuyao-powers/raw/master/scripts/install-plugin.sh | bash -s -- --targets codex,opencode

安装到项目

项目配置路径默认为 user scope，可以通过环境变量覆盖以安装到 project scope 或其他路径。

CURSOR_CONFIG_DIR=./.cursor \
CODEX_CONFIG_DIR=./.codex \
OPENCODE_CONFIG_DIR=./.config/opencode \
curl -fsSL https://gitcode.com/openFuyao/openfuyao-powers/raw/master/scripts/install-plugin.sh | bash

GitCode Token 读取

工具会优先读取环境变量 GITCODE_TOKEN；其次复用该工具已安装配置中的 token，最后则交互式询问。

各工具安装行为

工具	安装内容	目标路径
Cursor	插件 clone + MCP token	~/.cursor/plugins/local/openfuyao-powers/
Codex	插件 clone + marketplace 注册 + MCP token	~/.codex/plugins/openfuyao-powers/、~/.agents/plugins/marketplace.json
OpenCode	Skills 与 MCP 分别安装（非插件模型）	~/.config/opencode/skills/、~/.config/opencode/opencode.json

Codex：脚本会将插件注册到个人 marketplace（~/.agents/plugins/marketplace.json），source.path 相对 marketplace 根目录指向插件目录。安装完成后请重启 Codex，并在插件目录中启用 openfuyao-powers。若 marketplace 中已有其他插件，仅 upsert 本插件条目，不影响其余插件。

OpenCode：不遵循 Claude/Cursor 插件规范，脚本分别将 skills/ 同步到 skills/ 目录，并将 .mcp.json 中的 MCP 服务合并写入 opencode.json 的 mcp 段（保留 provider、agent 等其他配置项）。安装脚本依赖 jq 处理 JSON 配置。

功能清单

Skills

技能	描述	触发时机
requirement-decomposition	IR→SR→AR 三级需求拆解	收到原始需求文档、企业立项、社区提案
solution-design	方案设计与 4+1 架构视图	需求分析完成，进入方案设计阶段
ofep-converter	将方案设计转换为 oFEP 标准提案	需要输出社区提案
design2code	从方案设计文档端到端实现全部 Story（双 Agent 独立子上下文 + 人在回路 + PR 管理）	提供方案设计文档，要求实现 Story
i18n-refactor	前端中英双语改造	国际化、i18n、双语改造、多语言、中英文切换、翻译相关需求
gitcode-issue-fixer	Issue 自动化修复	修复 GitCode Issue
gitcode-issue-creator	在指定仓库创建 Issue（缺陷 / 需求）	提 Issue、新建缺陷单、需求单
issue-reviewer	评估 Issue 内容并生成修改建议	检查 Issue 标题、描述、标签、环境、日志、需求价值及需求/缺陷模板字段是否符合社区模板与信息完整性要求
gitcode-pr-manager	创建或同步 Pull Request	本地变更已 push，需要开 PR 或更新已有 PR
gitcode-pr-review	GitCode PR 评审	需要评审 Pull Request
gitcode-pr-codecheck	拉取 PR 门禁检查页 HTML、解析 CodeCheck 并按条修复（Node.js）	PR 门禁、CodeCheck、/pull/*/check、流水线静态检查失败
gitcode-pr-gate-diagnoser	诊断 GitCode PR 门禁失败并输出 UT/build/Helm/CodeCheck/SCA 修复建议，不直接修改代码	PR check 门禁失败、UT/build/Helm/CodeCheck/SCA 问题定位
code-reviewer	通用本地变更或 PR 变更代码评审（含质量量化评分与合入决策）	需要评审代码变更、Pull Request 或本地 diff
feature-level-test-cases-gen	依据特性提案、使用文档、项目源码等内容生成特性级集成测试用例	用户要求生成特性级集成测试用例时
test-cases-reviewer	以测试用例评审checklist、测试用例模板为依据对测试用例进行评审，输出评审报告	用户要求对测试用例进行评审时
dfx-test-cases-gen	依据特性提案、使用文档、项目源码等内容生成DFX测试用例	用户要求生成DFX测试用例时
e2e-issue-verifier	面向前端 Playwright / 后端 Ginkgo 的 e2e 失败分析、最小化验证与 Issue/PR 闭环	e2e 失败分析、验证结论判定、Issue/PR 交接
skill-governor	skill 治理与质量评估（review 评分、test prompt、受控优化）	评估 skill 质量、治理 skills、设计 test.json、按 rubric 打分或受控优化

Agents

暂无

内置 MCP

服务名称	简介	来源	使用须知
gitcode-mcp	Gitcode 平台功能 API 封装，用于 Issue、PR 的管理，基于 Node.js	yangxt65535/gitcode-mcp	需通过环境变量提供 GITCODE_TOKEN 个人令牌
plantuml-mcp-server	提供 plantuml 代码到图片生成功能，基于 Node.js	plantuml-mcp-server	默认使用 plantuml 官方渲染服务器，可更具需求修改为本地服务器

使用方式

在 Claude Code 中直接描述需求即可触发技能，例如：

请拆解需求：<需求描述>

或显式点名技能：

使用 gitcode-issue-fixer 解决问题单 https://gitcode.com/openFuyao/xxxxx/issue/XX

贡献指南

欢迎参与 openfuyao-powers 的能力建设。新增或修改 Skill、脚本、文档前，请先阅读 CONTRIBUTION.md。

目录结构

.claude-plugin/    # Claude Code 插件元数据
.codex-plugin/     # Codex 插件元数据（含 marketplace 模板）
.cursor-plugin/    # Cursor 插件元数据
scripts/           # Cursor / Codex / OpenCode 本地安装脚本
skills/            # Skill 定义
.mcp.json          # MCP 服务配置

OpenCode 无仓库内插件包；安装后 skills 与 MCP 分别写入 ~/.config/opencode/skills/ 与 ~/.config/opencode/opencode.json。

附录

项目参考：

• obra/superpowers
• awesome-skills/code-review-skill