record-sales
note 販売履歴を SSOT(data/note/sales.json)に記録するスキル。 ユーザーがダッシュボードからコピーした販売履歴テキストを受け取り、 sales-recorder エージェントで正規化・追記し、月次集計を表示する。 Use when user asks to [売上記録, 販売履歴を記録, note 売上, /record-sales].
SKILL.md.claude/skills/metrics/record-sales/SKILL.md
GitHub/record-sales
note 販売履歴を data/note/sales.json に記録し、月次集計を表示する。
用途
- note クリエイターダッシュボードからコピーした販売履歴を SSOT に追記
- 重複チェックにより二重記録を防止
- 月次/週次/商品別の集計表示
引数
| 引数 | 必須 | 説明 |
|---|---|---|
--summary |
No | 追記せず集計のみ表示 |
--month YYYY-MM |
No | 指定月の集計を表示(default: 当月) |
--validate |
No | productId の不明分をリストアップ(追記しない) |
実行手順
ケース 1: 販売履歴を記録
ユーザー: /record-sales
(続けて販売履歴テキストをペースト)
- ユーザーから販売履歴テキストを受け取る
- 親が直接、正規化して
data/note/sales.jsonに追記する(テキスト整形+JSON 追記は決定的な小作業なので委譲しない。productId の対応表は sales-tracking.md) - 結果(追加件数・スキップ件数・不明 productId)を表示
- 月次集計テーブルを表示
ケース 2: 集計のみ表示
/record-sales --summary
/record-sales --summary --month 2026-05
scripts/sales-summary.mjsを実行- 月次/商品別の集計を表示
ケース 3: productId 検証
/record-sales --validate
- 販売履歴テキストを解析
- productId が推定できない商品をリストアップ
- 追記はしない(dry-run)
販売履歴テキストの形式
note ダッシュボード → 売上 → 販売履歴 からコピーした形式:
2026年
6月
購入日が新しい順
すべて
ゲストユーザー
記事購入
技術士 建設部門|道路 R8予想 選択科目II-1 模範解答(全4予想設問)
2026年6月17日 05:16
500円
返信する
kuro
記事購入
技術士 建設部門|土質及び基礎 R07 選択科目II-2 模範解答(II-2-1・II-2-2)
2026年6月17日 00:48
500円
返信する
出力例
## 記録結果
- 追加: 15件
- スキップ(重複): 3件
- 不明 productId: 1件
- `article:unknown-20260617-1`: 技術士 建設部門|新規商品名
## 月次集計(2026-06)
| 商品 | 件数 | 売上 |
|---|---|---|
| essay-complete-pack | 5 | ¥39,900 |
| r8-essay-forecast | 3 | ¥10,440 |
| tankan-reading-guide | 3 | ¥5,940 |
| (単品記事計) | 12 | ¥6,800 |
| **合計** | **23** | **¥63,080** |
SSOT
| ファイル | 役割 |
|---|---|
data/note/sales.json |
販売履歴データ(手動転記) |
src/lib/note-magazines.ts |
マガジン ID マスター(価格・URL) |
.claude/knowledge/reference/sales-tracking.md |
運用手順書 |
トラブルシューティング
productId が推定できない
--validateで不明分を確認sales-recorder.mdの productId 推定ルールに追加- または
data/note/sales.jsonを直接編集して正しい productId に修正
重複が多すぎる
- 同じ期間を複数回ペーストしていないか確認
- 既存データの最終日付を確認:
jq '.sales | last | .date' data/note/sales.json
集計が合わない
npm run sales-summaryで検算- note ダッシュボードの「売上」金額と突合
参照
.claude/agents/sales-recorder.md— 正規化・追記を担当するエージェントscripts/sales-summary.mjs— 集計スクリプト.claude/knowledge/reference/sales-tracking.md— 運用手順・ポリシー