skills/skills.volces.com/contract-doc-sync

contract-doc-sync

Installation
SKILL.md

Contract Doc Sync

自动检测代码变更与 Contract 轨文档(docs/modules/ + docs/architecture/ + docs/conventions/)之间的漂移,按级别执行同步修复和多 Agent 共识验证。

Runtime Dependencies

依赖 类型 用途 不可用时
python3 硬依赖 运行 detect-changes.py(Phase 1) 技能无法启动,提示用户安装
git 硬依赖 detect-changes.py 调用 git diff 技能无法启动,提示用户安装
bash(含 sed/wc/find/tr) 硬依赖 运行 md-sections.sh 技能无法启动(所有 POSIX 系统均自带)
rg(ripgrep) 可选 子 Agent prompt 模板中推荐使用的搜索工具 退化使用 grep -rn,功能不变
Read/Edit/Bash 工具 硬依赖 文件读取、文档修改、脚本执行 Agent 平台原生提供,无需额外安装

requires.env: 无需额外环境变量。所有依赖均为标准开发工具。

环境变量说明:

  • $SKILL_DIR:由 Agent 运行平台(OpenCode / Claude Code)自动注入,指向本技能的安装目录。用户无需手动配置。
  • $MD_SECTIONS:由 Phase 0 Step 3 动态解析,优先使用项目 scripts/md-sections.sh,其次使用 $SKILL_DIR/scripts/md-sections.sh,均不可用时退化到 grep。用户无需手动配置。
Installs
1
First Seen
Apr 24, 2026