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。用户无需手动配置。