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 a la instalación

Repositorio: RNA4219/agent-taskstate
Última actividad en el origen: 6 de julio de 2026 a las 14:59
Idioma detectado de SKILL.md: inglés
Estrellas: 0
Forks: 0

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

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

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

2 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

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.