Initial commit

2025-11-29 18:08:19 +08:00
commit d03c46038c
21 changed files with 4951 additions and 0 deletions
--- a/commands/ace-export-patterns.md
+++ b/commands/ace-export-patterns.md
@@ -0,0 +1,106 @@
+---
+description: Export ACE playbook to JSON for backup or sharing
+---
+
+# ACE Export Playbook
+
+Export your ACE playbook to JSON for backup or cross-project sharing.
+
+## Instructions for Claude
+
+When the user runs `/ace:export-patterns`, use ce-ace CLI to export the playbook:
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v ce-ace >/dev/null 2>&1; then
+  echo "❌ ce-ace not found - Install: npm install -g @ace-sdk/cli"
+  exit 1
+fi
+
+# Read context
+ORG_ID=$(jq -r '.orgId // .env.ACE_ORG_ID // empty' .claude/settings.json 2>/dev/null || echo "")
+PROJECT_ID=$(jq -r '.projectId // .env.ACE_PROJECT_ID // empty' .claude/settings.json 2>/dev/null || echo "")
+
+# Try env wrapper format
+if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ]; then
+  ORG_ID=$(jq -r '.env.ACE_ORG_ID // empty' .claude/settings.json 2>/dev/null || echo "")
+  PROJECT_ID=$(jq -r '.env.ACE_PROJECT_ID // empty' .claude/settings.json 2>/dev/null || echo "")
+fi
+
+if [ -z "$PROJECT_ID" ]; then
+  echo "❌ Run /ace:configure first"
+  exit 1
+fi
+
+# Export playbook
+OUTPUT_FILE="${1:-ace-playbook-export.json}"
+
+echo "📦 Exporting ACE playbook..."
+
+if [ -n "$ORG_ID" ]; then
+  ce-ace --json --org "$ORG_ID" --project "$PROJECT_ID" export > "$OUTPUT_FILE"
+else
+  ce-ace --json --project "$PROJECT_ID" export > "$OUTPUT_FILE"
+fi
+
+if [ $? -eq 0 ]; then
+  PATTERN_COUNT=$(jq '.playbook | to_entries | map(.value | length) | add' "$OUTPUT_FILE" 2>/dev/null || echo "unknown")
+  FILE_SIZE=$(du -h "$OUTPUT_FILE" | cut -f1)
+
+  echo "✅ Playbook exported successfully!"
+  echo "   File: $OUTPUT_FILE"
+  echo "   Size: $FILE_SIZE"
+  echo "   Patterns: $PATTERN_COUNT"
+else
+  echo "❌ Export failed"
+  exit 1
+fi
+```
+
+## What Gets Exported
+
+The exported JSON contains:
+
+```json
+{
+  "playbook": {
+    "strategies_and_hard_rules": [
+      {
+        "id": "ctx-xxx",
+        "content": "Pattern content...",
+        "helpful": 5,
+        "harmful": 0,
+        "confidence": 1.0,
+        "evidence": [...],
+        "observations": 10
+      }
+    ],
+    "useful_code_snippets": [...],
+    "troubleshooting_and_pitfalls": [...],
+    "apis_to_use": [...]
+  }
+}
+```
+
+## Use Cases
+
+**Backup**:
+```
+/ace:export-patterns ace-backup-2025-01-20.json
+```
+
+**Cross-project sharing**:
+1. Export from project A: `/ace:export-patterns project-a-patterns.json`
+2. Import to project B: `/ace:import-patterns project-a-patterns.json`
+
+**Version control** (optional):
+- Export periodically to track playbook evolution
+- Commit to git for team sharing (careful with sensitive patterns!)
+
+## See Also
+
+- `/ace:import-patterns` - Import playbook from JSON
+- `/ace:status` - View current playbook stats
+- `/ace:clear` - Clear playbook before importing