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.