タイトル: "APIの実装"
→ エンコード後: API%E3%81%AE%E5%AE%9F%E8%A3%85

# python3を使ったURLエンコードと実行
python3 -c "
import urllib.parse
params = {
    'title': 'APIエンドポイントの実装をレビュー',
    'notes': 'Claude Codeが実装したPOST /api/auth/loginのレビュー\n\n受入基準:\n- テスト通過\n- ESLintエラーゼロ',
    'when': 'today',
    'tags': 'Claude Code,レビュー',
    'list': 'プロジェクト名'
}
query = urllib.parse.urlencode(params, quote_via=urllib.parse.quote)
url = f'things:///add?{query}'
print(url)
"

python3 -c "
import urllib.parse
params = {
    'title': 'SDD Phase 1: 基盤構築',
    'notes': 'SDDタスク管理 - Phase 1のタスク一覧',
    'when': 'today',
    'tags': 'SDD,Claude Code',
    'to-dos': '\n'.join([
        'TASK-001: データモデルの定義',
        'TASK-002: APIエンドポイントの実装',
        'TASK-003: 認証ミドルウェアの実装',
    ])
}
query = urllib.parse.urlencode(params, quote_via=urllib.parse.quote)
url = f'things:///add-project?{query}'
print(url)
"

python3 -c "
import urllib.parse, json

data = [
    {
        'type': 'project',
        'attributes': {
            'title': 'SDD Phase 1: 基盤構築',
            'notes': 'Claude Codeで管理中のSDDタスク',
            'when': 'today',
            'tags': ['SDD', 'Claude Code'],
            'items': [
                {
                    'type': 'heading',
                    'attributes': {
                        'title': 'データ層'
                    }
                },
                {
                    'type': 'to-do',
                    'attributes': {
                        'title': 'TASK-001: データモデルの定義',
                        'notes': '推定工数: 1時間\nステータス: TODO',
                        'tags': ['TODO']
                    }
                },
                {
                    'type': 'to-do',
                    'attributes': {
                        'title': 'TASK-002: APIエンドポイントの実装',
                        'notes': '推定工数: 2時間\nステータス: TODO\n依存: TASK-001',
                        'tags': ['TODO']
                    }
                },
                {
                    'type': 'heading',
                    'attributes': {
                        'title': 'ミドルウェア層'
                    }
                },
                {
                    'type': 'to-do',
                    'attributes': {
                        'title': 'TASK-003: 認証ミドルウェアの実装',
                        'notes': '推定工数: 1.5時間\nステータス: IN_PROGRESS\n依存: TASK-001',
                        'tags': ['IN_PROGRESS']
                    }
                }
            ]
        }
    }
]

json_str = json.dumps(data, ensure_ascii=False)
encoded = urllib.parse.quote(json_str)
url = f'things:///add-json?data={encoded}'
print(url)
"

# macOSで直接実行
open "things:///add?title=..."

# URLが長い場合は変数に格納して実行
URL=$(python3 -c "...URL生成スクリプト...")
open "$URL"

docs/sdd/tasks/
├── index.md           → Things プロジェクト（全体）
├── phase-1/
│   ├── task-001.md    → Things To-Do（見出し「Phase 1」配下）
│   ├── task-002.md    → Things To-Do
│   └── task-003.md    → Things To-Do
└── phase-2/
    ├── task-004.md    → Things To-Do（見出し「Phase 2」配下）
    └── task-005.md    → Things To-Do

Things プロジェクト: [プロジェクト名] SDDタスク
├── 見出し: Phase 1 - [フェーズ名]
│   ├── To-Do: TASK-001: [タスク名]
│   ├── To-Do: TASK-002: [タスク名]
│   └── To-Do: TASK-003: [タスク名]
└── 見出し: Phase 2 - [フェーズ名]
    ├── To-Do: TASK-004: [タスク名]
    └── To-Do: TASK-005: [タスク名]

# 受入基準 → チェックリスト
{
    "type": "to-do",
    "attributes": {
        "title": "TASK-001: データモデルの定義",
        "checklist-items": [
            {"title": "prisma/schema.prismaにUserモデルが定義されている"},
            {"title": "prisma migrateが正常に実行できる"},
            {"title": "TypeScript型定義が自動生成される"}
        ]
    }
}

1. docs/sdd/tasks/のindex.mdを読み取る
   ↓
2. 各フェーズのタスク詳細を読み取る
   ↓
3. ユーザーに送信対象を確認（全タスク or フィルタ）
   ↓
4. タスク構造をThings JSONにマッピング
   ↓
5. add-json URLを生成
   ↓
6. ユーザーに確認してURL実行
   ↓
7. 完了を報告

[things-url] ステップ 1/4: docs/sdd/tasks/を読み取り中...

docs/sdd/tasks/から以下のタスクを検出しました：

Phase 1: 基盤構築（3タスク）
  - TASK-001: データモデルの定義 [TODO]
  - TASK-002: APIエンドポイントの実装 [IN_PROGRESS]
  - TASK-003: 認証ミドルウェア [TODO]

Phase 2: UI実装（2タスク）
  - TASK-004: ログイン画面 [TODO]
  - TASK-005: ダッシュボード [TODO]

すべてのタスクをThingsに送信しますか？
それとも特定のフェーズ・ステータスでフィルタしますか？

[things-url] ステップ 2/4: Things JSON を構築中...

以下の構造でThingsに送信します：

プロジェクト: [プロジェクト名] SDDタスク
├── Phase 1: 基盤構築
│   ├── TASK-001: データモデルの定義 [タグ: TODO]
│   ├── TASK-002: APIエンドポイントの実装 [タグ: 進行中, when: today]
│   └── TASK-003: 認証ミドルウェア [タグ: TODO]
└── Phase 2: UI実装
    ├── TASK-004: ログイン画面 [タグ: TODO]
    └── TASK-005: ダッシュボード [タグ: TODO]

この内容でURLを生成してよろしいですか？

[things-url] ステップ 3/4: Things URL を生成中...

URLを生成しました。macOS環境のため直接実行します。

# URL生成と実行
URL=$(python3 -c "
import urllib.parse, json
# ... JSON構築とエンコード ...
")
open "$URL"

[things-url] ステップ 4/4: 完了

Things 3に以下を送信しました：
- プロジェクト: 1件
- 見出し: 2件
- To-Do: 5件

Things 3アプリで確認してください。

1. 現在のTodoWriteタスクを取得
   ↓
2. Things To-DoのJSON配列に変換
   ↓
3. ステータスに応じたタグ・when設定
   ↓
4. add-json URLを生成・実行
   ↓
5. 完了を報告

- [x] TASK-001: データモデルの定義（completed）
- [>] TASK-002: APIエンドポイントの実装（in_progress）
- [ ] TASK-003: 認証ミドルウェア（pending）

[
  {
    "type": "to-do",
    "attributes": {
      "title": "TASK-001: データモデルの定義",
      "completed": true,
      "tags": ["完了"]
    }
  },
  {
    "type": "to-do",
    "attributes": {
      "title": "TASK-002: APIエンドポイントの実装",
      "when": "today",
      "tags": ["進行中"]
    }
  },
  {
    "type": "to-do",
    "attributes": {
      "title": "TASK-003: 認証ミドルウェア",
      "tags": ["TODO"]
    }
  }
]

if [[ "$(uname)" != "Darwin" ]]; then
    echo "読み取り機能はmacOS環境でのみ利用可能です"
    exit 1
fi

[things-url] ステップ 1/3: macOS環境を確認中...
[things-url] ステップ 2/3: Things 3から今日のタスクを読み取り中...

osascript <<'APPLESCRIPT'
tell application "Things3"
    set todoList to to dos of list "Today"
    set output to ""
    set openCount to 0
    set doneCount to 0
    repeat with t in todoList
        set taskName to name of t
        set taskStatus to status of t
        if taskStatus is not canceled then
            set taskTagNames to name of tags of t
            set tagStr to ""
            repeat with i from 1 to count of taskTagNames
                if i > 1 then set tagStr to tagStr & ", "
                set tagStr to tagStr & item i of taskTagNames
            end repeat
            set output to output & "- " & taskName & " [" & taskStatus & "]"
            if tagStr is not "" then
                set output to output & " (tags: " & tagStr & ")"
            end if
            set output to output & linefeed
            if taskStatus is open then
                set openCount to openCount + 1
            else
                set doneCount to doneCount + 1
            end if
        end if
    end repeat
    if output is "" then
        return "(今日のタスクはありません)"
    end if
    set totalCount to openCount + doneCount
    set output to output & linefeed & "合計: " & totalCount & "件（未完了: " & openCount & "件、完了: " & doneCount & "件）"
    return output
end tell
APPLESCRIPT

[things-url] ステップ 3/3: 完了

Things 3「今日」のタスク一覧：
- [TASK-001]: データモデルの定義 [open] (tags: 進行中, SDD)
- [TASK-002]: APIエンドポイントの実装 [open] (tags: TODO, SDD)
- レビュー依頼への対応 [open] (tags: レビュー)
- ミーティング準備 [completed]

合計: 4件（未完了: 3件、完了: 1件）

osascript <<'APPLESCRIPT'
tell application "Things3"
    set projList to projects
    set output to ""
    repeat with p in projList
        if status of p is open then
            set projName to name of p
            set todoList to to dos of p
            set openCount to 0
            set doneCount to 0
            repeat with t in todoList
                if status of t is open then
                    set openCount to openCount + 1
                else if status of t is not canceled then
                    set doneCount to doneCount + 1
                end if
            end repeat
            set output to output & "## " & projName & " (未完了: " & openCount & ", 完了: " & doneCount & ")" & linefeed
            repeat with t in todoList
                set taskName to name of t
                set taskStatus to status of t
                if taskStatus is open then
                    set output to output & "  - [ ] " & taskName & linefeed
                else if taskStatus is not canceled then
                    set output to output & "  - [x] " & taskName & linefeed
                end if
            end repeat
            set output to output & linefeed
        end if
    end repeat
    if output is "" then
        return "(アクティブなプロジェクトはありません)"
    end if
    return output
end tell
APPLESCRIPT

osascript <<'APPLESCRIPT'
tell application "Things3"
    set targetTag to "SDD"
    set listNames to {"Inbox", "Today", "Upcoming", "Anytime", "Someday"}
    set output to ""

    -- 各ビルトインリストを検索
    repeat with listName in listNames
        set currentList to contents of listName
        repeat with t in to dos of list currentList
            set tagNames to name of tags of t
            if tagNames contains targetTag then
                set taskName to name of t
                set taskStatus to status of t
                if taskStatus is open then
                    set output to output & "- [ ] [" & currentList & "] " & taskName & linefeed
                else if taskStatus is not canceled then
                    set output to output & "- [x] [" & currentList & "] " & taskName & linefeed
                end if
            end if
        end repeat
    end repeat

    -- 各プロジェクト内も検索
    repeat with p in projects
        if status of p is open then
            repeat with t in to dos of p
                set tagNames to name of tags of t
                if tagNames contains targetTag then
                    set taskName to name of t
                    set taskStatus to status of t
                    if taskStatus is open then
                        set output to output & "- [ ] [" & name of p & "] " & taskName & linefeed
                    else if taskStatus is not canceled then
                        set output to output & "- [x] [" & name of p & "] " & taskName & linefeed
                    end if
                end if
            end repeat
        end if
    end repeat

    if output is "" then
        return "(「" & targetTag & "」タグのタスクはありません)"
    end if
    return output
end tell
APPLESCRIPT

1. osascriptでThings 3から対象リスト/プロジェクトのタスクを取得
   ↓
2. 現在のTodoWriteの状態と比較
   ↓
3. 差分を検出してユーザーに提示
   ↓
4. ユーザー承認
   ↓
5. TodoWriteを更新
   ↓
6. 完了を報告

[things-url] Things → TodoWrite 同期

以下の変更を検出しました：

変更あり:
  [TASK-001]: データモデルの定義
    Things: completed → TodoWrite: in_progress → 更新: completed
  [TASK-003]: 認証ミドルウェア
    Things: open (tag: 進行中) → TodoWrite: pending → 更新: in_progress

変更なし:
  [TASK-002]: APIエンドポイントの実装 (in_progress)

TodoWriteを更新してよろしいですか？

1. osascriptでThings 3からSDDプロジェクトのタスクを取得
   ↓
2. `[TASK-XXX]` IDでdocs/sdd/tasks/の各タスクと照合
   ※ `[TASK-XXX]`形式のIDを持つタスクのみ同期対象とする
   ※ `[TASK-XXX]`パターンに一致しないファイルはスキップして保持する
   ↓
3. ステータスの差分を検出
   ↓
4. ユーザーに差分を提示
   ↓
5. ユーザー承認
   ↓
6. docs/sdd/tasks/のタスクファイルを更新
   ※ `[TASK-XXX]` IDで照合されたファイルのみ更新する
   ※ 非SDDタスク（外部作成のファイル）は変更・削除しない
   ↓
7. TodoWriteも連動更新
   ※ 非SDDタスクのtodo（contentが`[Phase-`または`[BLOCKED] [Phase-`で始まらないもの）はそのまま保持する
   ↓
8. 完了を報告

auth-tokenはThings 3の設定画面から確認できます：
- Mac: Things → Settings → General → Enable Things URLs → Manage
- iOS: Settings → General → Things URLs

auth-tokenをお知らせください（このスキルでは保存しません）。

# ステップ1: ユーザーからauth-tokenを受け取り環境変数に設定
read -s -p "Things auth-token: " THINGS_AUTH_TOKEN && echo

# ステップ2: 環境変数経由でpython3に渡し、直接openコマンドで実行
THINGS_AUTH_TOKEN="$THINGS_AUTH_TOKEN" python3 -c "
import urllib.parse, subprocess, os
auth_token = os.environ['THINGS_AUTH_TOKEN']
params = {
    'id': 'THINGS_ITEM_ID',
    'auth-token': auth_token,
    'when': 'today',
    'append-notes': '\n\n[更新: YYYY-MM-DD] ステータスがIN_PROGRESSに変更されました'
}
query = urllib.parse.urlencode(params, quote_via=urllib.parse.quote)
url = f'things:///update?{query}'
subprocess.run(['open', url])
"

# add-projectでareaを指定
params = {
    'title': 'SDD Phase 1',
    'area': '開発プロジェクト',  # 既存のArea名
    # ...
}

# add-jsonでarea指定
{
    "type": "project",
    "attributes": {
        "title": "SDD Phase 1",
        "area": "開発プロジェクト",
        # ...
    }
}

プロジェクト: Phase 1 - 基盤構築（5タスク）
プロジェクト: Phase 2 - UI実装（3タスク）

プロジェクト: 全タスク（50タスク）  # 見通しが悪い

notes に含めるべき情報：
- タスクの目的・背景
- 受入基準（チェックリストにも反映）
- 依存関係
- 関連ファイルパス
- 推定工数