moc-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

FIWARE Orion 読み取り専用クエリ

FIWARE Orion 只读查询

FIWARE Orion Context Broker (NGSIv2) に対して、認証不要の GET のみでエンティティ情報を取得するスキルです。書き込み・Subscription・Registration は実装していません。

这是一款仅通过无需认证的GET请求，从FIWARE Orion Context Broker（NGSIv2）获取实体信息的Skill。未实现写入、Subscription（订阅）、Registration（注册）功能。

インストール

安装

skills CLI でインストールします（OpenCode / Claude Code / Cursor 等に対応）。

bash

npx skills add kzkski/moc-skill -a opencode -y
.agents/skills/moc-skill/scripts/setup-opencode.sh

setup-opencode.sh

は OpenCode のツール実行詳細（bash 出力など）をデフォルトで非表示にします。一般ユーザー向けの静かな UI 用です。詳細を見たいときは OpenCode で

/details

を実行してください。

ローカルパスから試す場合:

bash

npx skills add ./path/to/moc-skill --list
npx skills add ./path/to/moc-skill -a opencode -y
.agents/skills/moc-skill/scripts/setup-opencode.sh

通过skills CLI进行安装（支持OpenCode/Claude Code/Cursor等工具）。

bash

npx skills add kzkski/moc-skill -a opencode -y
.agents/skills/moc-skill/scripts/setup-opencode.sh

setup-opencode.sh

默认会隐藏OpenCode的工具执行详情（如bash输出），适用于面向普通用户的简洁UI。如需查看详情，请在OpenCode中执行

/details

。

从本地路径测试时：

bash

npx skills add ./path/to/moc-skill --list
npx skills add ./path/to/moc-skill -a opencode -y
.agents/skills/moc-skill/scripts/setup-opencode.sh

重要: アクセス経路

重要: 访问路径

必ず
scripts/orion.sh
経由でアクセスすること。カタログ外 URL へ直接

curl

しないでください。対象基盤は

endpoints.json

に登録された名前だけを使います。

npx skills add

後、

moc-skill

スキル配下の

scripts/orion.sh

を絶対パスで実行します。代表パス:

.agents/skills/moc-skill/scripts/orion.sh

（OpenCode / Cursor 等）

.claude/skills/moc-skill/scripts/orion.sh

（Claude Code）

~/.config/opencode/skills/moc-skill/scripts/orion.sh

（OpenCode グローバル）

エージェントは

**/moc-skill/scripts/orion.sh

を探索し、見つかったパスを

ORION

として使ってください。

orion.sh

は同ディレクトリ隣の

endpoints.json

を自動解決します。

bash

ORION="/path/to/moc-skill/scripts/orion.sh"

環境変数

ORION_ENDPOINTS_FILE

でカタログパスを上書きできます（未設定時はスキル同梱の

endpoints.json

）。

务必通过
scripts/orion.sh
进行访问，请勿直接对目录外的URL执行

curl

。仅使用

endpoints.json

中已注册的目标平台名称。

执行

npx skills add

后，以绝对路径运行

moc-skill

技能下的

scripts/orion.sh

。典型路径：

.agents/skills/moc-skill/scripts/orion.sh

（OpenCode/Cursor等）

.claude/skills/moc-skill/scripts/orion.sh

（Claude Code）

~/.config/opencode/skills/moc-skill/scripts/orion.sh

（OpenCode全局）

Agent会搜索

**/moc-skill/scripts/orion.sh

，将找到的路径设为

ORION

使用。

orion.sh

会自动解析同目录下的

endpoints.json

。

bash

ORION="/path/to/moc-skill/scripts/orion.sh"

可通过环境变量

ORION_ENDPOINTS_FILE

覆盖目录路径（未设置时使用技能自带的

endpoints.json

）。

回答フォーマット

回答格式

最終回答は一般ユーザーが読みやすい要約にすること。

orion.sh

の取得結果をそのまま貼り付けない。

一覧・比較・属性値は表または箇条書きで要約する
件数・基盤名・型名・主要属性など、依頼に答える情報だけを含める
実行したコマンド、curl、生 JSON、HTTP ヘッダーなどの技術的な詳細は最終回答に含めない
ユーザーが「生 JSON を見せて」「コマンドも教えて」「デバッグ用に全文」などと明示したときだけ技術的な出力を含める

最终回答需整理为普通用户易读的摘要，请勿直接粘贴

orion.sh

的获取结果。

列表、对比、属性值请用表格或项目符号进行摘要
仅包含能回应用户请求的信息，如数量、平台名、类型名、主要属性等
执行的命令、curl、原始JSON、HTTP头这类技术细节请勿包含在最终回答中
仅当用户明确要求「显示原始JSON」「告知命令」「提供完整内容用于调试」时，才包含技术输出

推奨ワークフロー

コマンドリファレンス

命令参考

コマンド	説明
`endpoints`	カタログに登録された基盤名・URL・Fiware-Service 一覧・説明を表示
`types <ep> [service=NAME]`	`GET /v2/types?options=count` （makeour.city では 401 のため使用しない）
`entities <ep> [k=v ...]`	`GET /v2/entities` （未指定時 `options=keyValues` `limit=20` を付与）
`entity <ep> <id> [k=v ...]`	`GET /v2/entities/{id}` （同上デフォルト付与）
`count <ep> [k=v ...]`	`limit=1&options=count` で `Fiware-Total-Count` ヘッダーのみ返す
`raw <ep> <path?query> [service=NAME]`	`/v2/` 配下に限定した任意 GET

<ep>

は

endpoints.json

のキー名（例:

Sandbox

sagacity

yokosuka

）。

複数 Fiware-Service: 1 エントリに配列で複数サービスを登録できます。クエリ時は

service=NAME

を指定してください（Orion へのクエリパラメータではなく、ヘッダー選択用の予約キー）。単一サービスのエントリでは

service=

は不要です。

命令	说明
`endpoints`	显示目录中已注册的平台名、URL、Fiware-Service列表及说明
`types <ep> [service=NAME]`	执行 `GET /v2/types?options=count` （makeour.city平台会返回401，请勿使用）
`entities <ep> [k=v ...]`	执行 `GET /v2/entities` （未指定时默认添加 `options=keyValues` `limit=20` ）
`entity <ep> <id> [k=v ...]`	执行 `GET /v2/entities/{id}` （同上默认添加参数）
`count <ep> [k=v ...]`	通过 `limit=1&options=count` 仅返回 `Fiware-Total-Count` 头信息
`raw <ep> <path?query> [service=NAME]`	仅对 `/v2/` 路径下执行任意GET请求

<ep>

为

endpoints.json

中的键名（示例：

Sandbox

sagacity

yokosuka

）。

多Fiware-Service场景：单个条目可通过数组注册多个服务。查询时需指定

service=NAME

（这是用于选择头信息的预留键，而非Orion的查询参数）。单服务条目无需指定

service=

。

デバッグ

调试

ORION_DRY_RUN=1

を設定すると curl コマンドを表示するだけで実行しません。

bash

ORION_DRY_RUN=1 "${ORION}" entities yokosuka type=WeatherForecast

设置

ORION_DRY_RUN=1

后，仅显示curl命令而不实际执行。

bash

ORION_DRY_RUN=1 "${ORION}" entities yokosuka type=WeatherForecast

NGSIv2 クエリパラメータ早見表

NGSIv2查询参数速查表

entities

entity

count

raw

の

[k=v ...]

または

raw

のクエリ文字列に指定します。

パラメータ	用途
`type`	Entity Type でフィルタ（例: `type=Device` ）
`q`	属性条件（例: `q=temperature>25` ）
`attrs`	返却属性の限定（例: `attrs=location,temperature` ）
`idPattern`	エンティティ ID の正規表現（例: `idPattern=^sensor-.*` ）
`limit`	最大取得件数（ `entities` / `entity` デフォルト 20）
`offset`	ページング開始位置
`orderBy`	ソート（例: `orderBy=!dateObserved` ）
`georel` + `geometry` + `coords`	地理空間クエリ（例: `georel=near;maxDistance:1000` `geometry=Point` `coords=-3.7,40.4` ）
`options`	レスポンス形式（ `keyValues` , `count` , `values` など）

可在

entities

entity

count

raw

的

[k=v ...]

或

raw

的查询字符串中指定以下参数。

参数	用途
`type`	按Entity Type过滤（示例： `type=Device` ）
`q`	属性条件过滤（示例： `q=temperature>25` ）
`attrs`	限定返回的属性（示例： `attrs=location,temperature` ）
`idPattern`	实体ID的正则匹配（示例： `idPattern=^sensor-.*` ）
`limit`	最大获取数量（ `entities` / `entity` 默认20）
`offset`	分页起始位置
`orderBy`	排序（示例： `orderBy=!dateObserved` ）
`georel` + `geometry` + `coords`	地理空间查询（示例： `georel=near;maxDistance:1000` `geometry=Point` `coords=-3.7,40.4` ）
`options`	响应格式（ `keyValues` , `count` , `values` 等）

注意点

注意事项

types は使わない: 登録基盤では
```
/v2/types
```
が 401。型探索は
```
entities
```
+
```
type=
```
/
```
count
```
で行う
読み取り専用: POST / PATCH / DELETE / Subscription / Registration は行わない
カタログ必須: 未定義のエンドポイント名は拒否される
raw は /v2/ のみ:
```
/v2/
```
以外へのパスはエラー
Entity ID:
```
[A-Za-z0-9._:~-]+
```
のみ許可（パストラバーサル対策）
Fiware ヘッダー:
```
endpoints.json
```
の
```
Fiware-Service
```
/
```
Fiware-ServicePath
```
が空でなければ自動付与。
```
Fiware-Service
```
が配列の場合は
```
service=
```
で選択
依存:
```
curl
```
,
```
jq
```
が PATH に必要

请勿使用types：已注册平台的
```
/v2/types
```
会返回401，需通过
```
entities
```
+
```
type=
```
/
```
count
```
进行类型查询
只读限制：不执行POST/PATCH/DELETE/Subscription/Registration操作
必须使用目录：未定义的端点名称会被拒绝
raw仅支持/v2/：
```
/v2/
```
以外的路径会报错
Entity ID限制：仅允许
```
[A-Za-z0-9._:~-]+
```
格式（防止路径遍历）
Fiware头信息：若
```
endpoints.json
```
中的
```
Fiware-Service
```
/
```
Fiware-ServicePath
```
不为空，则自动添加。
```
Fiware-Service
```
为数组时，需通过
```
service=
```
选择
依赖环境：PATH中需包含
```
curl
```
,
```
jq
```

カタログ形式 (

endpoints.json

)

目录格式 (

endpoints.json

)

json

{
  "endpoints": {
    "<名前>": {
      "base_url": "https://orion.<自治体>.makeour.city",
      "Fiware-Service": "単一ヘッダー値",
      "Fiware-ServicePath": "ヘッダー値(不要なら空文字)",
      "note": "説明"
    },
    "sagacity": {
      "base_url": "https://orion.sagacity.makeour.city",
      "Fiware-Service": [
        { "value": "moc_sagacity", "note": "MoC 佐賀" },
        { "value": "sagacity_topita", "note": "Topita" },
        { "value": "sagacity_ikunowa", "note": "保育園データ" }
      ],
      "Fiware-ServicePath": "",
      "note": "複数サービスを1エントリで管理"
    }
  }
}

Fiware-Service

は 文字列（単一）または配列（複数）を指定できます。配列要素は文字列、または

value

Fiware-ServicePath

note

を持つオブジェクトにできます。エントリ共通の

Fiware-ServicePath

は、オブジェクト側で未指定の場合のデフォルトになります。

新しい基盤を追加するときは、運用者が提供する Orion URL と Fiware ヘッダー値をこの形式で追記してください。

json

{
  "endpoints": {
    "<名称>": {
      "base_url": "https://orion.<自治体>.makeour.city",
      "Fiware-Service": "单一头信息值",
      "Fiware-ServicePath": "头信息值(无需则为空字符串)",
      "note": "说明"
    },
    "sagacity": {
      "base_url": "https://orion.sagacity.makeour.city",
      "Fiware-Service": [
        { "value": "moc_sagacity", "note": "MoC 佐贺" },
        { "value": "sagacity_topita", "note": "Topita" },
        { "value": "sagacity_ikunowa", "note": "保育园数据" }
      ],
      "Fiware-ServicePath": "",
      "note": "单个条目管理多个服务"
    }
  }
}

Fiware-Service

可指定为字符串（单一服务）或数组（多服务）。数组元素可为字符串，或包含

value

Fiware-ServicePath

note

的对象。条目通用的

Fiware-ServicePath

会作为对象未指定时的默认值。

添加新平台时，请按照此格式补充运维人员提供的Orion URL和Fiware头信息值。

moc-skill

Original

Translation

FIWARE Orion 読み取り専用クエリ

FIWARE Orion 只读查询

インストール

安装

重要: アクセス経路

重要: 访问路径

回答フォーマット

回答格式

推奨ワークフロー

推荐工作流程

コマンドリファレンス

命令参考

デバッグ

调试

NGSIv2 クエリパラメータ早見表

NGSIv2查询参数速查表

注意点

注意事项

カタログ形式 (
`endpoints.json`
)

目录格式 (
`endpoints.json`
)

moc-skill

Original

Translation

FIWARE Orion 読み取り専用クエリ

FIWARE Orion 只读查询

インストール

安装

重要: アクセス経路

重要: 访问路径

回答フォーマット

回答格式

推奨ワークフロー

推荐工作流程

コマンドリファレンス

命令参考

デバッグ

调试

NGSIv2 クエリパラメータ早見表

NGSIv2查询参数速查表

注意点

注意事项

カタログ形式 (endpoints.json)

目录格式 (endpoints.json)

カタログ形式 (
`endpoints.json`
)

目录格式 (
`endpoints.json`
)