artifact-access
Locate and read exact files across generated or versioned artifact roots, with stale-input detection and bounded output. Use when guessed paths, partial overlays, or oversized evidence repeatedly interrupt work; simple known-file reads can use ordinary tools.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-02
- Stars
- ★ 23
- Forks
- 1
01 前言 Front Matter
- name
- artifact-access
- description
- Locate and read exact files across generated or versioned artifact roots, with stale-input detection and bounded output. Use when guessed paths, partial overlays, or oversized evidence repeatedly interrupt work; simple known-file reads can use ordinary tools.
02 资源文件 3
- 参考文档agents/openai.yaml365 B
- 脚本scripts/artifact_access.py8.6 KB
- 脚本scripts/test_artifact_access.py3.9 KB
03 SKILL.md 正文
Artifact access
Use the existing manifest first. When its paths are already exact and sufficient,
do not create another inventory. For a generated tree without a usable manifest,
scripts/artifact_access.py inventory --root <explicit-task-root> --output <new-json>
creates a disposable path/hash view. It reads only the chosen tree, never searches
the home directory for a similar version and never modifies the source.
Read a member with:
python -B <skill>/scripts/artifact_access.py read --inventory <json> --path <exact/relative/file> --start 1 --lines 80
For an existing file manifest, pass --manifest <json> --root <explicit-root>
instead of --inventory. Supported manifests contain files or members rows
with relative path and sha256. The explicit root determines their meaning;
an installation's live path is not silently substituted for a candidate path.
The result includes exact source identity, selected lines, next_line and whether
that view covers the whole file. Follow next_line to EOF when a required Skill,
policy or source must be read completely. A bounded preview is not a full read.
Missing, duplicate, linked or changed members remain explicit errors; do not
silently fall back from an overlay to another release. Choose the actual baseline
or overlay from its existing manifest when both are required.
Use diff --left <file> --right <file> --lines 120 for a bounded ordinary unified
diff with both full-file hashes. The original files remain the evidence; a
truncated diff cannot certify complete change coverage.
For a large single-line JSON artifact, use json --file <exact-file> --pointer <JSON-pointer> --keys to list one object's keys, or omit --keys for its bounded
value. An empty pointer selects the root. Oversized selections fail explicitly;
choose a narrower pointer rather than printing the entire file. This selected
projection never counts as reading a mandatory full source.
For repeated material operations whose first fault/next use matters, the existing
local master-guided-skill-lifecycle operation runner can retain this script's
actual exit status and full stdout/stderr. This Skill also runs independently;
it does not require a workflow registry, create learning authority, or certify
that the inspected product works. Its exact input and result—not a read count—
are the useful learning evidence.
04 同仓库更多 Skills
workflow-transition-admission
Admit or hold a source-bound same-chat correction, candidate transition, known-cause retry, finalized Skill-dependent action, external action or decision-window wait from one identity-bound receipt. Preserve independent refutation, actual allocation-result consumption and lightweight read-only work. This is structural admission only, not semantic or outcome proof. Read legacy v1 only for explicit old split-chat leases.
scenario-interaction-closure
Freeze a source-bound, blind-first harm-scenario and interaction closure before a material correction, then preserve its meaning through evidence decomposition and recomposition.
powershell-exact-action
Screen an exact finalized PowerShell command or batch member before execution for confirmed mechanical recurrence families, currently the invalid direct pipeline from a foreach statement and unsafe literal-dollar interpolation in metadata arguments. Use for Windows PowerShell actions after wrappers, defaults, JSON construction, member expansion, and quoting are final. It is a mechanical preflight, not semantic safety or runtime outcome proof.
objective-supervisor-control
Turn a same-chat or legacy decision-bearing event into a bounded source-bound objective-control disposition without fixed polling or status narration. Use when consuming a result, correcting objective drift or deciding whether a wait has value; never treat this control pass as independent review or action authority.
master-guided-skill-resolver
Compile provenance-bound source and finalized action facts, then resolve exact registered workflow skills with deterministic path- and hash-bound selected/rejected receipts. Use before material work when the two masters may contain reusable skill guidance, or when diagnosing missing, near, stale, conflicting, retired, or ambiguous selection. This skill does not replace the workflow, semantic judgment, independent review, or final-consumer evidence.
master-guided-skill-lifecycle
Carry worthwhile workflow learning from a real result to an owned candidate, next use and measured disposition; retrieve source-bound master history, validate Skill effects and steward operating conditions or exact user-approved amendments. Use at material results, recurrence, useful reuse, avoidable cost, capability changes or a concrete policy-condition blocker. Do not turn ordinary reads into extra phases or treat records and invocations as benefit.