Skip to content
Back to skills

Artifacts

ASecurity

- **ステータス**: 採用 - **決定日**: 2026-08-20

  • 50 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 7, 2026
developmentapi

Works with

  • api

Security analysis

A100/100

Pro scans all 21 files and shows the line behind each finding

Scanned November 7, 2026

npx -y skills add iwasa-kosui/tanteki --skill artifacts --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Artifacts?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Artifacts
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/iwasa-kosui-artifacts-54de0f79/badge)](https://www.skillsdirectory.com/skills/iwasa-kosui-artifacts-54de0f79)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
# ADR: 請求書PDF生成を非同期キューで処理する

- **ステータス**: 採用
- **決定日**: 2026-08-20

## コンテキスト

請求書のPDF生成には最大45秒かかる場合があります。同期処理ではAPI接続が切断される可能性があるため、リクエスト中に生成完了を待つ方式は安定しません。

## 決定

請求書のPDF生成はキューに投入し、非同期で処理します。APIは受付時点で受付IDを返します。利用者は受付IDを使って処理状況を確認し、完成後にPDFを取得します。

## 代替案と判断理由

### 同期生成

採用しません。生成に最大45秒かかり、API接続が切断される可能性があるためです。

### 非同期生成

採用します。API接続を長時間維持せずに済みます。一方、利用者はPDFの完成まで待つ必要があります。この待ち時間は、受付IDによる状況確認と完成後の取得で扱います。

## 影響

- APIの応答はPDF本体ではなく受付IDになります。
- 利用者は生成完了まで待機し、状況確認または完成通知後にPDFを取得する必要があります。
- キュー、ワーカー、処理状態、失敗時の扱いを運用する必要があります。
- 再試行の上限は未決定であり、別途決定する必要があります。

## 実装・運用上の留意点

- 受付IDから処理状態を確認できるようにします。
- 完成したPDFを受付IDと関連付けて取得できるようにします。
- 失敗状態と利用者向けのエラー情報を定義します。
- 再試行の上限、バックオフ、重複生成を防ぐ冪等性を決定します。

Files in this skill

  • adr-boundary.1.with_skill.md753 B
  • adr-boundary.1.without_skill.md1.1 KB
  • adr-boundary.2.with_skill.md755 B
  • adr-boundary.2.without_skill.md1.7 KB
  • canonical-reference.1.with_skill.md277 B
  • canonical-reference.1.without_skill.md286 B
  • canonical-reference.2.with_skill.md312 B
  • canonical-reference.2.without_skill.md302 B
  • comparison-rfc.1.with_skill.md1.1 KB
  • comparison-rfc.1.without_skill.md1.2 KB
  • comparison-rfc.2.with_skill.md1.3 KB
  • comparison-rfc.2.without_skill.md1.3 KB
  • design-tradeoff.1.with_skill.md3.2 KB
  • design-tradeoff.1.without_skill.md2.5 KB
  • design-tradeoff.2.with_skill.md1.8 KB
  • design-tradeoff.2.without_skill.md5.3 KB
  • incident-record.1.with_skill.md623 B
  • incident-record.1.without_skill.md473 B
  • incident-record.2.with_skill.md599 B
  • incident-record.2.without_skill.md681 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.