{
  "schemaVersion": "1.0",
  "item": {
    "slug": "project-context-sync",
    "name": "Project Context Sync",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "canonicalUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/project-context-sync",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/install.sh",
      "scripts/post-commit-hook.sh",
      "scripts/uninstall.sh",
      "scripts/update-context.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "project-context-sync",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T11:17:25.116Z",
      "expiresAt": "2026-05-14T11:17:25.116Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=project-context-sync",
        "contentDisposition": "attachment; filename=\"project-context-sync-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "project-context-sync"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/project-context-sync"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/project-context-sync",
    "agentPageUrl": "https://openagent3.xyz/skills/project-context-sync/agent",
    "manifestUrl": "https://openagent3.xyz/skills/project-context-sync/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/project-context-sync/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "project-context-sync",
        "body": "Keep a living project state document updated after each commit, so any agent (or future session) can instantly understand where things stand."
      },
      {
        "title": "What It Does",
        "body": "┌─────────────┐     ┌──────────────────┐     ┌─────────────────────┐\n│ Git Commit  │ ──▶ │ Post-commit Hook │ ──▶ │ PROJECT_STATE.md    │\n│             │     │                  │     │ (auto-updated)      │\n└─────────────┘     └──────────────────┘     └─────────────────────┘\n\nAfter each commit, the hook:\n\nGathers git info (last commit, recent history, branch, changed files)\nOptionally calls an LLM to generate a smart summary\nUpdates PROJECT_STATE.md in the repo root"
      },
      {
        "title": "Installation",
        "body": "# From the repo you want to enable:\ncd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/install.sh\n\nOr if you have the skill in your path:\n\nproject-context-sync install\n\nThis will:\n\nInstall a post-commit hook in .git/hooks/\nCreate .project-context.yml with default config\nCreate initial PROJECT_STATE.md\nAdd PROJECT_STATE.md to .gitignore"
      },
      {
        "title": "Uninstall",
        "body": "cd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/uninstall.sh"
      },
      {
        "title": "Manual Update",
        "body": "Trigger an update without committing:\n\ncd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/update-context.sh"
      },
      {
        "title": "Configuration",
        "body": "Edit .project-context.yml in your repo root:\n\nproject_context:\n  # Use AI to generate smart summaries (default: true)\n  ai_summary: true\n  \n  # How many recent commits to include\n  recent_commits: 5\n  \n  # Include diff stats in context\n  include_diff_stats: true\n  \n  # Sections to include\n  sections:\n    - last_commit\n    - recent_changes\n    - current_focus    # AI-generated\n    - suggested_next   # AI-generated"
      },
      {
        "title": "AI Summary Mode",
        "body": "With ai_summary: true (default):\n\nGenerates intelligent summaries of what changed\nInfers current focus from recent commit patterns\nSuggests next steps\nCosts tokens but provides rich context\nRequires: Gateway HTTP API enabled (see below)\n\nWith ai_summary: false:\n\nJust logs raw git info\nFast and free\nLess intelligent but still useful"
      },
      {
        "title": "Enabling the Gateway HTTP API",
        "body": "AI mode uses Clawdbot's OpenAI-compatible endpoint (/v1/chat/completions). This is disabled by default for security. To enable:\n\n// ~/.clawdbot/clawdbot.json\n{\n  \"gateway\": {\n    \"http\": {\n      \"endpoints\": {\n        \"chatCompletions\": { \"enabled\": true }\n      }\n    }\n  }\n}\n\nSecurity notes:\n\nThe endpoint inherits gateway auth (requires bearer token)\nWith bind: \"loopback\" (default), only local processes can connect\nThe script reads the token from ~/.clawdbot/clawdbot.json automatically\nRisk is minimal for local development setups"
      },
      {
        "title": "Output",
        "body": "PROJECT_STATE.md will contain:\n\n# Project State\n*Auto-updated by project-context-sync*\n\n## Last Commit\n- **Hash:** abc123\n- **Message:** Implement isPro check for app blocking\n- **Branch:** feature/subscription-gating\n- **When:** 2026-01-29 12:34\n- **Files changed:** 3\n\n## Recent Changes\n- abc123: Implement isPro check for app blocking\n- def456: Add PaywallPrompt component\n- ...\n\n## Current Focus\n[AI-generated summary of what's being worked on]\n\n## Suggested Next Steps\n[AI-suggested based on commit patterns]"
      },
      {
        "title": "Notes",
        "body": "PROJECT_STATE.md is gitignored by default (regenerated locally)\nThe hook requires Clawdbot to be running for AI summaries\nWithout Clawdbot, falls back to raw git info mode"
      }
    ],
    "body": "project-context-sync\n\nKeep a living project state document updated after each commit, so any agent (or future session) can instantly understand where things stand.\n\nWhat It Does\n┌─────────────┐     ┌──────────────────┐     ┌─────────────────────┐\n│ Git Commit  │ ──▶ │ Post-commit Hook │ ──▶ │ PROJECT_STATE.md    │\n│             │     │                  │     │ (auto-updated)      │\n└─────────────┘     └──────────────────┘     └─────────────────────┘\n\n\nAfter each commit, the hook:\n\nGathers git info (last commit, recent history, branch, changed files)\nOptionally calls an LLM to generate a smart summary\nUpdates PROJECT_STATE.md in the repo root\nInstallation\n# From the repo you want to enable:\ncd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/install.sh\n\n\nOr if you have the skill in your path:\n\nproject-context-sync install\n\n\nThis will:\n\nInstall a post-commit hook in .git/hooks/\nCreate .project-context.yml with default config\nCreate initial PROJECT_STATE.md\nAdd PROJECT_STATE.md to .gitignore\nUninstall\ncd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/uninstall.sh\n\nManual Update\n\nTrigger an update without committing:\n\ncd /path/to/your/repo\n/path/to/skills/project-context-sync/scripts/update-context.sh\n\nConfiguration\n\nEdit .project-context.yml in your repo root:\n\nproject_context:\n  # Use AI to generate smart summaries (default: true)\n  ai_summary: true\n  \n  # How many recent commits to include\n  recent_commits: 5\n  \n  # Include diff stats in context\n  include_diff_stats: true\n  \n  # Sections to include\n  sections:\n    - last_commit\n    - recent_changes\n    - current_focus    # AI-generated\n    - suggested_next   # AI-generated\n\nAI Summary Mode\n\nWith ai_summary: true (default):\n\nGenerates intelligent summaries of what changed\nInfers current focus from recent commit patterns\nSuggests next steps\nCosts tokens but provides rich context\nRequires: Gateway HTTP API enabled (see below)\n\nWith ai_summary: false:\n\nJust logs raw git info\nFast and free\nLess intelligent but still useful\nEnabling the Gateway HTTP API\n\nAI mode uses Clawdbot's OpenAI-compatible endpoint (/v1/chat/completions). This is disabled by default for security. To enable:\n\n// ~/.clawdbot/clawdbot.json\n{\n  \"gateway\": {\n    \"http\": {\n      \"endpoints\": {\n        \"chatCompletions\": { \"enabled\": true }\n      }\n    }\n  }\n}\n\n\nSecurity notes:\n\nThe endpoint inherits gateway auth (requires bearer token)\nWith bind: \"loopback\" (default), only local processes can connect\nThe script reads the token from ~/.clawdbot/clawdbot.json automatically\nRisk is minimal for local development setups\nOutput\n\nPROJECT_STATE.md will contain:\n\n# Project State\n*Auto-updated by project-context-sync*\n\n## Last Commit\n- **Hash:** abc123\n- **Message:** Implement isPro check for app blocking\n- **Branch:** feature/subscription-gating\n- **When:** 2026-01-29 12:34\n- **Files changed:** 3\n\n## Recent Changes\n- abc123: Implement isPro check for app blocking\n- def456: Add PaywallPrompt component\n- ...\n\n## Current Focus\n[AI-generated summary of what's being worked on]\n\n## Suggested Next Steps\n[AI-suggested based on commit patterns]\n\nNotes\nPROJECT_STATE.md is gitignored by default (regenerated locally)\nThe hook requires Clawdbot to be running for AI summaries\nWithout Clawdbot, falls back to raw git info mode"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "publisherUrl": "https://clawhub.ai/Joe3112/project-context-sync",
    "owner": "Joe3112",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/project-context-sync",
    "downloadUrl": "https://openagent3.xyz/downloads/project-context-sync",
    "agentUrl": "https://openagent3.xyz/skills/project-context-sync/agent",
    "manifestUrl": "https://openagent3.xyz/skills/project-context-sync/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/project-context-sync/agent.md"
  }
}