Skip to content

feat: add pt-snap-helper skill and agent help epilog - #144

Merged
codeasier merged 3 commits into
mainfrom
issue-139-pt-snap-helper
Sep 18, 2026
Merged

codeasier merged 3 commits into
mainfrom
issue-139-pt-snap-helper

Conversation

@codeasier

Copy link
Copy Markdown
Owner

📝 Description

Add pt-snap-helper as the packaged routing skill for agents, and surface a root --help epilog so agents prefer --json where the current CLI supports it and check skill availability with pt-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. --json examples match current capability (skill *, metadata, report peak-memory); full-command JSON remains #138.

🔗 Related Issue

Fixes #139

🧪 Testing

  • Tests added/updated
  • Manual testing completed
  • 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.py
  • Full suite: 867 passed, 1 xfailed
  • ruff check . and black --check on edited Python files

✅ Checklist

  • Code follows project guidelines
  • Documentation updated (if applicable)
  • No new warnings introduced
  • Changes tested locally

Snapshot Runtime Provenance

  • Snapshot provenance evaluation completed when snapshot runtime files change
    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.md copies live under skills/pt-snap-helper/ and src/pt_snap_cli/bundled_skills/pt-snap-helper/ so pt-snap skill install ships the helper to PyPI users.

@codeasier codeasier left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

交叉评审(多模型并行)

评审范围:本 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 消耗与成本。

Comment thread tests/skills/test_helper_contract.py Resolved
Comment thread tests/skills/test_helper_contract.py Resolved
Comment thread skills/AGENTS.md Resolved
codeasier 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
codeasier force-pushed the issue-139-pt-snap-helper branch from b94133f to c045aff Compare September 18, 2026 12:57

@codeasier codeasier left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

跟进交叉评审(第二轮,head c045aff2,3 模型并行)

上轮 3 条 low 已核实全部修复:契约测试改为 get_command(app) 反射逐命令断言 --json 有无、路径锚定 Path(__file__).resolve().parents[2]、措辞改为 "the five skills"。结论维持 Approve,无 critical/high/medium 问题;本轮新增 2 条 low 见行内评论。

Comment thread tests/test_cli.py Resolved
Comment thread skills/pt-snap-helper/SKILL.md Resolved
Root epilog must not appear in query -h, and outdated-skill remediation needs a concrete skill upgrade --json example in both SKILL.md copies.
@codeasier
codeasier merged commit ce04fe1 into main Sep 18, 2026
6 checks passed
@codeasier
codeasier deleted the issue-139-pt-snap-helper branch October 3, 2026 19:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] 新增 pt-snap-helper 引导技能,并在 --help 输出中加入 Agent 提示

1 participant