跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
效率与协作

generic-commit-convention

Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work.

modiqo · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add modiqo/skillspec --skill generic-commit-convention

技能说明


name: generic-commit-convention description: "Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work."

Commit Convention

Write conventional commit messages and run the repository's pre-push checks before commit, push, or PR title work.

This skill is a thin loader for the colocated skill.spec.yml. The spec is the source of truth for routes, rules, dependencies, imports, resources, recipes, tests, and trace requirements.

Runtime Contract

  1. Load ./skill.spec.yml from this skill folder before taking task actions.

  2. When the skillspec CLI is available, run:

    skillspec decide ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"
    
  3. Strip skill invocation prefixes such as /my-skill, $my-skill, or /rote-shell-spec before passing --input.

  4. Preserve the emitted trace run_dir.

  5. When the CLI is available after a trace exists, run skillspec trace align ./skill.spec.yml --decision-trace <run_dir> and report the alignment status with the trace path.

  6. Follow the selected route, matched rules, forbids, elicitations, dependencies, imports, recipes, and closures from skill.spec.yml.

  7. If the CLI is unavailable, read skill.spec.yml directly and apply its rules manually. Do not expand this loader into a second source of truth.

Quick Commands

skillspec validate ./skill.spec.yml
skillspec imports check ./skill.spec.yml
skillspec test ./skill.spec.yml
skillspec deps check ./skill.spec.yml
skillspec explain ./skill.spec.yml --input='<user task>' --trace-dir "${PWD}/.skillspec/traces"
skillspec trace align ./skill.spec.yml --decision-trace "${PWD}/.skillspec/traces/<run-id>"

Completion Report

When reporting completion, include the selected route, the SkillSpec trace run_dir, the skillspec trace align status (pass, fail, or unproven), key failed or unproven alignment checks, and the concrete execution evidence ids or files.

Route Hints

  • message_only: Draft commit message only
  • pre_push_gate: Run pre-push checks
  • commit_ready: Prepare commit-ready output