Agent Skills › meamaturinlove221/TuringResearch_plus › tulingresearch-cache-and-ledger

tulingresearch-cache-and-ledger

GitHub

用于保护确定性缓存键、元数据、失败重试、预算门控及状态账本追加行为。当工作涉及所有者车道、相关合约、模块或测试时触发，确保更新文件并通过测试。

.agents/skills/tulingresearch-cache-and-ledger/SKILL.md meamaturinlove221/TuringResearch_plus

Trigger Scenarios

修改共享缓存逻辑变更失败账本记录调整BudgetGate预算门控配置更新StateLedger状态账本

Install

npx skills add meamaturinlove221/TuringResearch_plus --skill tulingresearch-cache-and-ledger -g -y

More Options

Non-standard path

npx skills add https://github.com/meamaturinlove221/TuringResearch_plus/tree/main/.agents/skills/tulingresearch-cache-and-ledger -g -y

Use without installing

npx skills use meamaturinlove221/TuringResearch_plus@tulingresearch-cache-and-ledger

指定 Agent (Claude Code)

npx skills add meamaturinlove221/TuringResearch_plus --skill tulingresearch-cache-and-ledger -a claude-code -g -y

安装 repo 全部 skill

npx skills add meamaturinlove221/TuringResearch_plus --all -g -y

预览 repo 内 skill

npx skills add meamaturinlove221/TuringResearch_plus --list

SKILL.md

Frontmatter

{
    "name": "tulingresearch-cache-and-ledger",
    "description": "Use when changing shared cache, failure ledger, BudgetGate, or StateLedger foundations."
}

TulingResearch Plus Skill: tulingresearch-cache-and-ledger

Role

Protect deterministic cache keys, cache metadata, failure retries, budget gates, and state ledger append behavior.

When to use

Use this skill when work touches the owner lane, related contracts, modules, tests, or release gates listed below.

Inputs

User request naming tulingresearch-cache-and-ledger or the matching TulingResearch Plus lane.
Existing contracts, Pydantic models, tests, docs, and ledger entries.
Fake-service or dry-run fixtures when workflow behavior is involved.

Outputs

Updated TulingResearch Plus files in the listed required paths.
Passing focused tests and release-safe documentation updates.
Ledger updates in lanes/00_master_ledger.md and the owner lane.

Required files

src/tuling_research/cache/
src/tuling_research_plus/budget/
src/tuling_research_plus/ledger/

Related contracts

contracts/core_tools.yaml
contracts/error_schema.yaml
contracts/artifact_schema.yaml

Related lanes

lanes/06_workflow_orchestration.md

Required tests

tests/unit/test_cache_keys.py
tests/unit/test_cache_manager.py
tests/unit/test_failure_ledger.py
tests/unit/test_budget_models.py
tests/unit/test_state_ledger.py

Rules / constraints

Project display name is TulingResearch Plus.
Core package is tuling_research and Plus package is tuling_research_plus.
MCP server name is tulingresearch-plus.
Skill names must use the tulingresearch- prefix.
Keep work inside TulingResearch/TulingResearch_plus.
Do not require real network access, external API keys, or live service calls in tests.
Preserve EvidenceRef, ResearchArtifact, BudgetGate, and StateLedger boundaries when relevant.
Use service protocols or adapters for external APIs.
Update the owner lane and lanes/00_master_ledger.md after meaningful changes.

Done criteria

Implementation status: locked.
Release requirement: release-critical.
Related tests pass or a release blocker is explicitly recorded.
Documentation and contracts remain aligned with current TulingResearch Plus naming.