agent-taskstate-maintainer

Maintain and verify the ..\agent-taskstate repository. Use when working in this repo to review requirements, fix implementation gaps, align code with docs, tests, and schema, update README guidance, or prepare acceptance, commit, and push. Triggers include requests about typed_ref, context bundles, resolver, tracker bridge, kv-priority-roadmap, and repo-specific code review.

Ir para a instalação

Repositório: RNA4219/agent-taskstate
Última atividade na origem: 6 de julho de 2026 às 14:59
Idioma detectado do SKILL.md: inglês
Estrelas: 0
Forks: 0

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/RNA4219/agent-taskstate --skill agent-taskstate-maintainer

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos

2 arquivos

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

Agent-taskstate Maintainer

Overview

Use this skill only inside agent-taskstate. Treat docs/kv-priority-roadmap/ as requirement supplements that must stay consistent with the implementation.

Workflow

Read the relevant context in this order when needed:

README.md
BLUEPRINT.md
GUARDRAILS.md
matching file under docs/src/
matching file under docs/kv-priority-roadmap/

Map the request to the main modules before editing:

typed_ref: src/typed_ref.py, tests/test_typed_ref.py, docs/contracts/typed-ref.md
context bundle: src/context_bundle.py, tests/test_context_bundle.py, docs/schema/agent-taskstate.sql
resolver: src/resolver.py, tests/test_context_rebuild_resolver.py
tracker bridge: src/tracker_bridge.py, tests/test_tracker_bridge.py
state transition: src/state_transition.py, tests/test_state_transition.py

Update implementation, tests, and schema/docs together when the behavior changes.

Validate with pytest -q before finishing. Use narrower suites only while iterating.

Inspect git status --short before commit and exclude __pycache__, workflow-cookbook/, and unrelated local artifacts.

Repo Invariants

Keep typed_ref in 4-segment canonical form: <domain>:<entity_type>:<provider>:<entity_id>.

Keep agent-taskstate as the source of truth for internal task state. Treat tracker data as auxiliary input.

Preserve context bundle auditability: diagnostics, source refs, raw-inclusion flags, and generator metadata must remain traceable.

When asked for review, report bugs, requirement gaps, and regression risks before summaries.

When editing docs, keep README.md agent-oriented and README-human.md human-oriented.

Acceptance Pass

Re-check the relevant roadmap item under docs/kv-priority-roadmap/.

Confirm the touched tests cover the changed behavior.

If schema or migration contracts moved, update both docs/schema/agent-taskstate.sql and docs/migrations/001_init.sql.

Commit in Japanese and push only after verification succeeds.