← 返回 Skills 市场
Project Context Sync
作者
Joseph Sagiv
· GitHub ↗
· v1.0.0
2874
总下载
3
收藏
9
当前安装
1
版本数
在 OpenClaw 中安装
/install project-context-sync
功能描述
Automatically updates PROJECT_STATE.md after each commit with recent git info and optional AI-generated summaries to track project status and next steps.
安全使用建议
What to check before installing:
- Review the scripts locally (install.sh, update-context.sh, post-commit-hook.sh). The installer will modify .git/hooks/post-commit and write .project-context.yml and PROJECT_STATE.md into the repo.
- Understand AI mode: if ai_summary: true, the hook may read ~/.clawdbot/clawdbot.json or the CLAWDBOT_TOKEN env var and POST commit context (commit messages, changed filenames, diff stats) to http://localhost:<port>/v1/chat/completions with that bearer token. Confirm your Clawdbot gateway is configured to bind only to loopback and is not proxying requests to an external/untrusted service.
- Secrets: the script reads a token from your home config — treat that as sensitive. If you don't want any tokens read or network calls, set ai_summary: false in .project-context.yml before installing.
- Tooling: the scripts use git, curl, and optionally jq; ensure those are available. Note sed -i '' is BSD/macOS style and may not work unchanged on Linux (the install/uninstall scripts use it).
- Test safely: install in a disposable/test repository first to observe behavior. Make a commit and inspect PROJECT_STATE.md and whether any network calls occur (e.g., run update-context.sh manually and watch curl).
- Uninstall: uninstall.sh will attempt to remove the hook or the appended lines; it leaves PROJECT_STATE.md and .project-context.yml in place (remove manually if desired).
Given the undeclared access to a local token file and the potential to transmit repository information, proceed only if you trust the code and your local Clawdbot gateway configuration. If you want to be conservative, disable ai_summary or inspect/modify update-context.sh to remove or alter the network call before installing.
功能分析
Type: OpenClaw Skill
Name: project-context-sync
Version: 1.0.0
The skill `project-context-sync` is designed to auto-update a `PROJECT_STATE.md` file in a Git repository after each commit. It achieves this by installing a `post-commit` Git hook. The skill can optionally use a local Clawdbot AI gateway to generate smart summaries, which involves reading the `CLAWDBOT_TOKEN` from `~/.clawdbot/clawdbot.json` and making a `curl` request to `http://localhost:$GATEWAY_PORT`. While accessing a credential file (`~/.clawdbot/clawdbot.json`) is a sensitive operation, it is explicitly documented in `SKILL.md` and `README.md`, and the token is used solely for local communication with the Clawdbot gateway, aligning with the skill's stated purpose. There is no evidence of data exfiltration to external endpoints, malicious execution, or prompt injection attempts against the agent.
能力评估
Purpose & Capability
The skill's name and files match its stated purpose (install a post-commit hook that keeps PROJECT_STATE.md up-to-date). However, the shipped scripts read a Clawdbot gateway config (~/.clawdbot/clawdbot.json) and may use a CLAWDBOT_TOKEN — these runtime interactions are related to the AI-summary feature but are not declared in the skill's metadata (no required env vars or binaries are listed).
Instruction Scope
The runtime script (update-context.sh) collects repository metadata (commit messages, changed files, diff stats) and, when AI mode is enabled, will send that context to a local HTTP gateway endpoint (/v1/chat/completions) with a bearer token read from the user's Clawdbot config or from environment (CLAWDBOT_TOKEN). That behavior is within the feature's scope, but it reads a user config file and a secret token (undocumented in metadata) and transmits repository context to a network endpoint — potential data exposure if the gateway is misconfigured or forwards requests externally.
Install Mechanism
No external downloads or remote installs are performed; install.sh copies provided scripts into the repository's .git/hooks and writes .project-context.yml and PROJECT_STATE.md. This is expected for a hook-based tool, but it does modify repo hooks and .gitignore. The install script also uses sed -i '' (BSD sed) which may be platform-specific.
Credentials
skill.json declares no required env vars or binaries, but update-context.sh expects git, curl, and (optionally) jq and reads ~/.clawdbot/clawdbot.json or CLAWDBOT_TOKEN for a bearer token. The token read from the user's home config is effectively a secret; requesting/using it is relevant to AI summaries but the metadata doesn't declare that requirement or ask for user confirmation, so there's a mismatch.
Persistence & Privilege
always is false and the skill only installs a per-repository post-commit hook (no system-wide always-on flag). The hook runs update-context.sh in the background on each commit. It does not modify other skills or global agent settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install project-context-sync - 安装完成后,直接呼叫该 Skill 的名称或使用
/project-context-sync触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: auto-update PROJECT_STATE.md with AI-powered summaries after each commit
元数据
常见问题
Project Context Sync 是什么?
Automatically updates PROJECT_STATE.md after each commit with recent git info and optional AI-generated summaries to track project status and next steps. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2874 次。
如何安装 Project Context Sync?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install project-context-sync」即可一键安装,无需额外配置。
Project Context Sync 是免费的吗?
是的,Project Context Sync 完全免费(开源免费),可自由下载、安装和使用。
Project Context Sync 支持哪些平台?
Project Context Sync 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Project Context Sync?
由 Joseph Sagiv(@joe3112)开发并维护,当前版本 v1.0.0。
推荐 Skills