项目状态同步

技能简介

project-context-sync 在每次 Git 提交后自动更新项目状态文档，让任何代理或后续会话都能快速了解项目当前进展。

能做什么

• 每次提交后自动收集 Git 信息（最近提交、分支、变更文件）
• 可选调用 LLM 生成智能摘要
• 更新根目录下的 PROJECT_STATE.md 文件
• 支持手动触发更新，无需等待提交

使用说明

安装步骤：

1. 进入目标仓库：cd /path/to/your/repo
2. 执行安装脚本：/path/to/skills/project-context-sync/scripts/install.sh
3. 或将技能加入 PATH 后直接运行：project-context-sync install

安装完成后会自动：安装 post-commit 钩子、创建 .project-context.yml 配置文件、生成初始 PROJECT_STATE.md、将该文件加入 .gitignore。

卸载：/path/to/skills/project-context-sync/scripts/uninstall.sh

手动更新：/path/to/skills/project-context-sync/scripts/update-context.sh

配置说明：编辑 .project-context.yml 可调整 AI 摘要开关、最近提交数量、是否包含 diff 统计、输出章节等。启用 AI 摘要需开启 Gateway HTTP API（默认关闭），在 ~/.clawdbot/clawdbot.json 中设置 gateway.http.endpoints.chatCompletions.enabled 为 true。

输入与输出

见下方输入与输出表格。

风险提示

• AI 摘要模式消耗 token，且需要 Clawdbot 运行中
• Gateway HTTP API 开启后需妥善保管 bearer token
• PROJECT_STATE.md 默认被 gitignore，团队成员需各自生成本地副本
• 若 Clawdbot 未运行，将回退到原始 Git 信息模式

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/joe3112/project-context-sync/SKILL.md
来源类型：开源社区技能