Skip to content
Back to skills

Artifacts

ASecurity

ファイル取込を非同期化し、APIはファイルの保存と解析処理の登録までを受け付ける。解析結果は後からDBに保存する。

  • 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-59db89fe/badge)](https://www.skillsdirectory.com/skills/iwasa-kosui-artifacts-59db89fe)

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
# ファイル取込の設計

## 背景と目標

ファイル取込を非同期化し、APIはファイルの保存と解析処理の登録までを受け付ける。解析結果は後からDBに保存する。

## 対象範囲

対象は、APIによるファイル保存、キューへの登録、ワーカーによる解析、解析結果のDB保存である。利用者への結果提示は非同期となるため、提示までの時間が延びる。

## 設計

APIは次の順で処理する。

1. 受け取ったファイルをオブジェクトストレージへ保存する。
2. 保存先をキューへ登録する。
3. 登録結果を利用者へ返す。

オブジェクトストレージへの保存に失敗した場合、APIは503を返し、キューには登録しない。

ワーカーはキューから保存先を受け取り、オブジェクトストレージからファイルを読み込む。解析結果をDBへ保存する。

## 代替案と不採用理由

ファイル本体をキューへ載せる案は採用しない。対象ファイルは10MBであり、キューの上限1MBを超えるためである。

## 影響

非同期化により、利用者が解析結果を確認できるまでの時間が延びる。ファイル本体をキューへ載せず保存先だけを登録するため、キューのサイズ制限には抵触しない。

## リスクと未解決点

オブジェクトストレージへの保存後、キューへの登録に失敗した場合の回復方法は未決定である。この場合の再登録方法と、保存済みファイルの扱いを別途決める必要がある。

## 可逆性

キューへの登録失敗時の回復方法が未決定のため、現時点では回復を含む運用手順を確定できない。

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

iwasa-kosuiView sourceSee grades on GitHubMore from iwasa-kosui

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.