AGENT SKILL

skill-evolution

Recommends skill changes from recorded tool-call patterns and conduct corrections asserted by the human user or observed by the response model, when the human user asks for such recommendations or their pending backlog, or authorizes that analysis.

License 许可
Apache-2.0
所属仓库
AidALL/ghost-alice
最近更新
2026-11-15
Stars
★ 15
Forks
4

01 前言 Front Matter

name
skill-evolution
description
Recommends skill changes from recorded tool-call patterns and conduct corrections asserted by the human user or observed by the response model, when the human user asks for such recommendations or their pending backlog, or authorizes that analysis.
compatibility
[ "Python 3.11+ standard library" ]

02 资源文件 4

03 SKILL.md 正文

Skill Evolution

The response model uses this report-only workflow to find repeated tool and workflow patterns and supported corrections of its conduct. It reads the io-trace records and, when supplied, the intent ledger of the exact session. It returns candidate recommendations.

Inputs and triggers

Use the workflow when the human user asks about skill upgrades, recommendations or an evolution backlog, or when the human user's instructions authorize an analysis of repeated tool sequences. The default trace source is ~/.ghost-alice/io-trace.jsonl; isolated fixtures may be selected explicitly.

When the SQLite ledger exists, the analyzer reads it through the public ledger API with the supplied ledger root, host and session. The intent-state.json argument is a compatibility path that selects that session's ledger. A portable JSON file can support offline reports but cannot establish the current work selection or permission.

The response model reads its interpreted-as record from the recorded current goal, the accumulated constraints and non-goals, the decisions that no later decision replaced and the latest scope. These fields explain behavior; they do not by themselves authorize execution or resolve conflicting boundaries.

Analyze and dispose

  1. The response model selects the skill's default trace source or a path the human user named, and the window, then uses the host's shell tool to run python3 <loaded-skill-directory>/scripts/analyze_io_trace.py <selected-trace-path> --window <selected-window> --json, adding --intent-ledger <state_path from the session metadata> when the exact session is known. Every path is an absolute path established earlier; the state_path value selects that session's ledger through the storage API.
  2. For each instincts candidate, it assesses the observed behavior or failure and its effect on the applicable contract. Tool frequency alone does not prove a conduct mismatch.
  3. It then considers quality_summary, candidate quality and the analyzer's suggested_next_step as proposed next steps. Recency, authorship and artifact preservation do not grant approval. In an older report, decision holds the same proposed next step; if both fields occur with different values, the response model reports the conflict and does not select a next step from that item.
  4. It assigns every considered candidate a disposition from the closed list absorb | project-local | session-only | reject | defer, with an accountable owner ID in lowercase-hyphenated form, a proposed action and a rationale. Watch/reject triage candidates still receive this disposition.
  5. If the disposition explicitly proposes follow-up work, that work needs the human user's authorization and passes necessity-gate before it runs. A defer/reject disposition grants no action. Even suggested_next_step=route-to-systematic-debugging stays report content here; this report-only workflow does not start implementation.
  6. The response model performs edits the human user accepted only under the editing procedure that the human user's instructions separately authorize.

When the human user asks for the full backlog across sessions, the response model runs python3 <loaded-skill-directory>/scripts/aggregate_recommendations.py --root <authorized-ledger-root> --json; the root comes from the ledger the human user selected or from the trusted session metadata or runtime context. For one session, run the analyzer with that session's state_path. Open entries appear as conduct:<id> even when the session has no tool activity. Read the actual JSON keys and the command status before interpreting the result; the response model adds dispositions to its report, not to the stored state, and does not assume that the analyzer made those judgments of meaning. A failed or unreadable result leaves the requested coverage unresolved.

Conduct feedback

Session-intent-analyzer defines how the response model records corrections, assigns their sources and asks the human user to confirm a new conduct correction the model proposes. The report reads conduct_feedback as a signal in its own right. The aggregator groups entries with pattern_class by failure family and lists their member IDs; entries without a class stay grouped by ID. The stored occurrence count records how often a supported correction repeated within a session. A correction labeled user-said or a recurring pattern receives high priority; the label records the response model's claim about the origin, not proof of a human assertion. Missing or blank legacy source labels appear as unknown. The response model checks the original evidence before treating an unknown or unsupported label as an assertion by the human user.

The response model names the skill or document whose rules could prevent the behavior: for example, boundary-contract for scope, using-coding-convention for execution discipline, and verification-before-completion for false completion. It assesses the behavior and its effect on the contract before deciding whether a proposed change is justified.

Output

{
  "window": 1000,
  "event_count": 3,
  "quality_summary": {"review": 1, "watch": 0, "reject": 0},
  "instincts": [{
    "id": "sequence:read-edit-bash",
    "trigger": "Read -> Edit -> Bash sequence",
    "domain": "sequence",
    "scope": "project",
    "evidence": "3 occurrences",
    "quality": "review",
    "suggested_next_step": "necessity-gate",
    "session_count": 2,
    "quality_reasons": ["cross-session-evidence"]
  }],
  "dispositions": [{
    "candidate_id": "sequence:read-edit-bash",
    "disposition": "defer",
    "owner": "skill-evolution",
    "action": "none",
    "rationale": "observed contract impact is not yet established"
  }]
}

quality values serve triage only: review indicates a possible pattern across sessions, watch indicates limited evidence of frequency or sessions, and reject indicates suspected local debugging or noise.

Blind installed-behavior evaluation

When an evaluation that the human user's instructions authorize concerns installed behavior, follow the source-tree docs/policies/live-smoke-regression.md procedure. That procedure defines how the subject and the evaluator are isolated, how the runtime executes and how results are classified. Only its evaluator-confirmed behavioral failure supplies a report-only conduct-feedback candidate; a harness or transport failure does not establish misconduct by the response model.

Warnings

The response model must not auto-evolve, auto-promote, auto-create skills or install background hooks. The response model's interpreted-as record comes from the ledger's compressed state, never from prompt text. This workflow does not use the network, MCP or credentials, and must not depend on personal absolute paths.

04 同仓库更多 Skills

AidALL
AidALL/ghost-alice

session-intent-analyzer

Records the response model's new or changed interpretation of the input the response model is answering as its `interpreted-as` record before the first tool call of work, and reads that record when it can change the objective, constraints, work choice or whether earlier work continues.

★ 15
AidALL
AidALL/ghost-alice

necessity-gate

Judges whether proposed work is justified, needs a narrower scope or is unjustified, when the response model proposes new work or the human user asks whether to do it.

★ 15
AidALL
AidALL/ghost-alice

merge-companion

Reviews the installer's backups of external changes to installed skills and merges each into the new skill version, discards or defers it as the human user chooses, before a task changes or reinstalls an installed skill, or when the human user asks for that review.

★ 15
AidALL
AidALL/ghost-alice

compact-handoff

Writes a handoff of the task's objective, scope, evidence and next action when a long conversation, compaction or handover to another session or agent could lose them, and resumes the task from it afterwards.

★ 15
AidALL
AidALL/ghost-alice

writing-skills

Writes a new skill or changes an existing one in its folder (SKILL.md, references and scripts) and tests it.

★ 15
AidALL
AidALL/ghost-alice

writing-plans

Writes an implementation plan that breaks requirements the human user accepted into tasks a newcomer to the project can carry out, after the human user settles decisions only the human user can make and the response model settles technical choices within what the human user's instructions authorize, before implementation.

★ 15