Files
gh-jmanhype-claude-code-plu…/skills/playbook_epoch_1.json
2025-11-30 08:27:42 +08:00

260 lines
8.0 KiB
JSON

{
"version": "1.0.0",
"schema_version": "1.0.0",
"last_updated": "2025-10-26T23:00:00Z",
"bullets": [
{
"id": "appworld-login-001",
"title": "Always call login() before using any app API methods",
"content": "Every AppWorld app requires authentication. Always call app.login() as the FIRST operation before making any API calls. Example: spotify.login(), venmo.login(), gmail.login(). Skipping login will cause 'access_token' errors.",
"tags": [
"app.spotify",
"app.venmo",
"app.gmail",
"app.general",
"authentication",
"critical"
],
"evidence": [],
"links": [],
"confidence": "high",
"scope": "global",
"prerequisites": [],
"author": "seed",
"status": "active",
"helpful_count": 125,
"harmful_count": 3,
"last_updated": "2025-10-27T12:33:11.269633",
"created": "2025-10-26T23:00:00Z"
},
{
"id": "appworld-search-002",
"title": "Use search_* methods not get_* or fetch_* for querying data",
"content": "AppWorld APIs use search_* naming convention (e.g., spotify.search_tracks(), venmo.search_transactions()). Don't use get_* or fetch_* - those don't exist. Always check available methods for each app.",
"tags": [
"app.spotify",
"app.venmo",
"app.gmail",
"api_naming",
"critical"
],
"evidence": [],
"links": [],
"confidence": "high",
"scope": "global",
"prerequisites": [],
"author": "seed",
"status": "active",
"helpful_count": 123,
"harmful_count": 2,
"last_updated": "2025-10-27T02:59:40.558445",
"created": "2025-10-26T23:00:00Z"
},
{
"id": "appworld-complete-003",
"title": "Always call apis.supervisor.complete_task() at the end",
"content": "Every AppWorld task MUST end with apis.supervisor.complete_task() to signal completion. This is required for the test framework to evaluate results. Missing this call will cause all tests to fail.",
"tags": [
"app.general",
"task_completion",
"critical"
],
"evidence": [],
"links": [],
"confidence": "high",
"scope": "global",
"prerequisites": [],
"author": "seed",
"status": "active",
"helpful_count": 125,
"harmful_count": 3,
"last_updated": "2025-10-27T12:33:11.269631",
"created": "2025-10-26T23:00:00Z"
},
{
"id": "appworld-error-004",
"title": "Check API response structure before accessing nested fields",
"content": "AppWorld API responses can have varying structures. Always check if fields exist before accessing them (e.g., if 'items' in response, check response.get('data'), etc.). Use .get() with defaults to avoid NoneType errors.",
"tags": [
"app.general",
"error_handling",
"defensive"
],
"evidence": [],
"links": [],
"confidence": "high",
"scope": "global",
"prerequisites": [],
"author": "seed",
"status": "active",
"helpful_count": 125,
"harmful_count": 2,
"last_updated": "2025-10-27T07:28:18.738967",
"created": "2025-10-26T23:00:00Z"
},
{
"id": "appworld-spotify-005",
"title": "Spotify: Get user playlists and track details separately",
"content": "To find songs in Spotify playlists: (1) Call spotify.get_user_playlists() to get playlist IDs, (2) For each playlist, call spotify.get_playlist_tracks(playlist_id) to get track details including likes/plays.",
"tags": [
"app.spotify",
"playlists",
"pattern"
],
"evidence": [],
"links": [
"appworld-login-001"
],
"confidence": "high",
"scope": "app",
"prerequisites": [
"appworld-login-001"
],
"author": "seed",
"status": "active",
"helpful_count": 125,
"harmful_count": 3,
"last_updated": "2025-10-27T12:33:11.269627",
"created": "2025-10-26T23:00:00Z"
},
{
"id": "bullet-2025-10-27-012842",
"title": "Verify general API logic and requirements",
"content": "When implementing general operations: Check task logic and requirements; Missing login() call for general",
"tags": [
"logic",
"debugging",
"api",
"app.general"
],
"evidence": [
{
"type": "execution",
"ref": "82e2fac_1",
"note": "Task failed with logic_error: Tests failed: 1/2"
}
],
"helpful_count": 0,
"harmful_count": 0,
"confidence": "medium",
"scope": "app",
"prerequisites": [],
"author": "reflector",
"status": "active",
"created": "2025-10-27T01:28:42.340996",
"last_updated": "2025-10-27T01:28:42.340997",
"links": []
},
{
"id": "bullet-2025-10-27-012856",
"title": "Verify venmo API logic and requirements",
"content": "When implementing venmo operations: Check task logic and requirements; Missing login() call for venmo",
"tags": [
"logic",
"debugging",
"api",
"app.venmo"
],
"evidence": [
{
"type": "execution",
"ref": "2a163ab_1",
"note": "Task failed with logic_error: Tests failed: 1/6"
}
],
"helpful_count": 0,
"harmful_count": 0,
"confidence": "medium",
"scope": "app",
"prerequisites": [],
"author": "reflector",
"status": "active",
"created": "2025-10-27T01:28:56.281941",
"last_updated": "2025-10-27T01:28:56.281946",
"links": []
},
{
"id": "bullet-2025-10-27-025940",
"title": "Review general API implementation",
"content": "Task 'What is the title of the most-liked song in my Spotify playlists.' failed with logic_error. Review API usage and error handling.",
"tags": [
"api",
"debugging",
"app.general"
],
"evidence": [
{
"type": "execution",
"ref": "fallback_reflection",
"note": "Fallback bullet (LLM reflection unavailable)"
}
],
"confidence": "low",
"scope": "app",
"created": "2025-10-27T02:59:40.558459",
"last_updated": "2025-10-27T12:33:11.269624",
"helpful_count": 2,
"harmful_count": 1,
"status": "active"
},
{
"id": "bullet-2025-10-27-072605",
"title": "Review general API implementation",
"content": "Task 'What is the title of the most-liked song in my Spotify playlists.' failed with logic_error. Review API usage and error handling.",
"tags": [
"api",
"debugging",
"app.general"
],
"evidence": [
{
"type": "execution",
"ref": "fallback_reflection",
"note": "Fallback bullet (LLM reflection unavailable)"
}
],
"confidence": "low",
"scope": "app",
"created": "2025-10-27T07:28:18.738970",
"last_updated": "2025-10-27T12:33:11.269629",
"helpful_count": 0,
"harmful_count": 1,
"status": "active"
},
{
"id": "bullet-2025-10-27-123311",
"title": "Verify spotify API logic and requirements",
"content": "When implementing spotify operations: Check task logic and requirements; Missing login() call for spotify",
"tags": [
"logic",
"debugging",
"api",
"app.spotify"
],
"evidence": [
{
"type": "execution",
"ref": "82e2fac_1",
"note": "Task failed with logic_error"
}
],
"helpful_count": 0,
"harmful_count": 0,
"confidence": "low",
"scope": "app",
"prerequisites": [],
"author": "reflector_fallback",
"status": "active",
"created": "2025-10-27T12:33:11.268061",
"last_updated": "2025-10-27T12:33:11.268063",
"links": []
}
],
"metadata": {
"total_bullets": 10,
"active_bullets": 10,
"deprecated_bullets": 0,
"archived_bullets": 0,
"last_curated": "2025-10-27T12:33:11.269640"
}
}