Repository navigation
feat: add pt-snap-helper skill and agent help epilog - #144
Merged
Merged
Conversation
codeasier
commented
Sep 18, 2026
codeasier
left a comment
Owner
Author
There was a problem hiding this comment.
交叉评审(多模型并行)
评审范围:本 PR head b94133f 的隔离快照。评审员:volceapi/qwen3.8-flash、opencode-go/deepseek-v4.1-flash、opencode-go/muse-spark-1.3-contributor(3/3 成功,quorum 2)。结论:Approve,无 critical/high/medium 问题。
以下 3 条 low 级发现经父会话独立核实成立,见行内评论。已核实无误的部分:仓库与 bundled 两份 SKILL.md 字节一致(blob 2c1089c)、--json 能力声明与 cli.py:306,571,702,764,820,875 一致、epilog 仅挂根命令且不泄漏到 --json/--version 输出、--no-focus 与 SkillStatus 字面量准确、中英文文档对齐。
注:多模型并行评审会增加 token 消耗与成本。
added 2 commits
September 18, 2026 20:57
Give agents a packaged routing entry and a root --help hint so they can pick the next skill and prefer --json on currently supported commands. Fixes #139
Whole-file cli.py substrings could not fail if query or focus gained --json. Inspect Typer command options instead, read skill files from the repo root, and stop calling setup/collection targets analysis skills.
codeasier
force-pushed
the
issue-139-pt-snap-helper
branch
from
September 18, 2026 12:57
b94133f to
c045aff
Compare
codeasier
commented
Sep 18, 2026
codeasier
left a comment
Owner
Author
There was a problem hiding this comment.
跟进交叉评审(第二轮,head c045aff2,3 模型并行)
上轮 3 条 low 已核实全部修复:契约测试改为 get_command(app) 反射逐命令断言 --json 有无、路径锚定 Path(__file__).resolve().parents[2]、措辞改为 "the five skills"。结论维持 Approve,无 critical/high/medium 问题;本轮新增 2 条 low 见行内评论。
Root epilog must not appear in query -h, and outdated-skill remediation needs a concrete skill upgrade --json example in both SKILL.md copies.
This was referenced Sep 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📝 Description
Add
pt-snap-helperas the packaged routing skill for agents, and surface a root--helpepilog so agents prefer--jsonwhere the current CLI supports it and check skill availability withpt-snap skill list --json.The helper is read-only: it does not install packages, import pickle, or persist focus. Pickle-only users get a separate trusted-input import explanation.
--jsonexamples match current capability (skill *,metadata,report peak-memory); full-command JSON remains #138.🔗 Related Issue
Fixes #139
🧪 Testing
pytest tests/skills/test_helper_contract.py tests/test_bundled_skills.py tests/test_cli.py tests/core/test_skill_service.py tests/test_completion.pyruff check .andblack --checkon edited Python files✅ Checklist
Snapshot Runtime Provenance
Snapshot provenance decision: no-update
Snapshot provenance no-update reason: This PR only adds a bundled helper skill, root help epilog, tests, and docs; it does not change src/pt_snap_cli/snapshot/.
📋 Additional Notes
Identical
SKILL.mdcopies live underskills/pt-snap-helper/andsrc/pt_snap_cli/bundled_skills/pt-snap-helper/sopt-snap skill installships the helper to PyPI users.