AgentSkillsCN

repo-c-ranking-contracts

在<PRIVATE_REPO_C>中，持续维护排名引擎的行为与模式兼容性。在调整评分权重、排名/倍率逻辑、报表序列化，或下游系统所使用的`ranking_report`模式契约时，请务必使用此方法。

SKILL.md
--- frontmatter
name: repo-c-ranking-contracts
description: Maintain ranking engine behavior and schema compatibility in <PRIVATE_REPO_C>. Use when modifying scoring weights, ranking/multiplier logic, report serialization, or `ranking_report` schema contracts consumed by downstream systems.

Repo C Ranking Engine Contracts

Use this skill for Ranking Engine logic and contract-safe updates.

Workflow

  1. •Update repo_c/ranking_engine.py with deterministic scoring changes.
  2. •Validate report serialization against schema expectations.
  3. •Verify tests covering engine behavior and schema conformance.

Commands

Run from <PRIVATE_REPO_C> root:

bash
ruff check .
pytest -q tests/test_ranking_engine.py tests/test_schema_validation.py

Schema alignment target:

  • •schemas/ranking_report.schema.json

Contract Notes

  • •Keep RankingEngineReport.to_dict() output stable.
  • •Preserve apply_credit(report, base_credit) multiplier semantics.
  • •Additive schema evolution preferred over breaking changes.

Reference

  • •references/ranking-contracts.md