tsubakimototsubakimoto/skills/backlog-api/SKILL.md

backlog-api

Skill2 starsChanged 8 months agoMITView on GitHub

Backlog（ヌーラボ社のプロジェクト管理SaaS）のREST API v2に関するエキスパートスキル。課題の作成・検索・更新、プロジェクト管理、Wiki操作、Git/プルリクエスト、通知、チーム管理などBacklog APIを使ったコード生成や自動化を支援する。Backlog APIの認証方式、エンドポイント、パラメータ、エラーハンドリングについて質問されたとき、またはBacklog連携スクリプトやアプリを構築するときに使用する。

Reads credentials

In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- azure-paas-supportSkill
- azure-resource-abbreviationsSkill
- csharp-file-based-appsSkill
- dependabot-auto-mergeSkill
- devblog-updatesSkill
- github-changelogSkill
- github-entra-federated-credentialsSkill
- git-worktreeSkill
- hatena-blog-publisherSkill
- marp-cssSkill
- marp-deckSkill
- summarized-postSkill

The file

Create a free account to mount

Files

SKILL.md

Backlog API Expert

Backlog API v2 を使った開発を支援するスキル。

API概要

ベースURL: https://{スペースID}.backlog.com/api/v2 または https://{スペースID}.backlog.jp/api/v2
形式: REST API（JSON）
公式ドキュメント: https://developer.nulab.com/ja/docs/backlog/
詳細なAPI仕様: references/backlog-v2-openapi.yml を参照

前提条件

Backlogスペースへのアクセス権
API Key（スペースの「個人設定」>「API」から発行）または OAuth 2.0 アクセストークン
.NET 10 SDK 以降（C# file-based app 実行用）

認証

API Key認証（クエリパラメータ）

GET /api/v2/space?apiKey=YOUR_API_KEY

OAuth 2.0（Authorizationヘッダー）

Authorization: Bearer YOUR_ACCESS_TOKEN

APIカテゴリ

カテゴリ	ベースパス	主な操作
スペース	`/space`	情報取得、お知らせ、容量、添付ファイル送信
ユーザー	`/users`	CRUD、認証ユーザー情報、活動履歴、スター
チーム	`/teams`	CRUD、アイコン（`/groups` は非推奨）
プロジェクト	`/projects`	CRUD、状態・種別・カスタム属性、Webhook
課題	`/issues`	CRUD、検索、コメント、添付ファイル
Wiki	`/wikis`	CRUD、タグ、添付ファイル、更新履歴
Git	`/projects/.../git/repositories`	リポジトリ、プルリクエスト
お知らせ	`/notifications`	一覧取得、既読化
マスターデータ	`/priorities`, `/resolutions`	優先度・完了理由一覧

各エンドポイントの詳細パラメータは references/backlog-v2-openapi.yml を参照。

課題検索パラメータ（`GET /issues`）

パラメータ	説明
`projectId[]`	プロジェクトID（複数指定可）
`statusId[]`	状態ID（複数指定可）
`assigneeId[]`	担当者ID（複数指定可）
`issueTypeId[]`	種別ID（複数指定可）
`keyword`	検索キーワード
`sort`	ソート属性（`created`, `updated`, `dueDate` 等）
`order`	`asc` / `desc`（デフォルト `desc`）
`count`	取得上限 1-100（デフォルト 20）
`offset`	オフセット
`createdSince` / `createdUntil`	登録日範囲 (yyyy-MM-dd)
`parentChild`	0:すべて, 1:子課題以外, 2:子課題, 4:親課題

共通パターン

ページネーション

count（1-100）と offset を組み合わせる

複数値パラメータ

statusId[]=1&statusId[]=2

ID指定方式

{issueIdOrKey}: 数値ID または課題キー（例: PROJECT-123）
{projectIdOrKey}: 数値ID またはプロジェクトキー（例: PROJECT）

C#スクリプト

基本的な操作は C# file-based app の scripts/backlog_api.cs を実行または参照する。

# 実行例
dotnet run --file scripts\backlog_api.cs -- --space myspace --api-key YOUR_KEY get-issues --project-id 12345

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free