ppw:update

Purpose

This Skill syncs local .claude/skills/ and references/ from the upstream GitHub repository Lylll9436/Paper-Polish-Workflow-skill. It downloads the latest SKILL.md files and reference documents, compares them with local versions, and updates any changed files.

Trigger

Activates when the user asks to:

• Update or sync skills from the remote repo
• 更新或同步技能包

Example invocations:

• "update skills"
• "sync skills from GitHub"
• "更新技能"

Modes

Mode	Default	Behavior
direct	Yes	Fetch, compare, update, report — no intermediate confirmation
interactive		Show diff summary before applying each update

Default mode: direct

Workflow

Step 0: Workflow Memory Check

• Read .planning/workflow-memory.json. If file missing or empty, skip to Step 1.
• Check if the last 1-2 log entries form a recognized pattern with ppw:update that has appeared >= threshold times in the log. See skill-conventions.md > Workflow Memory > Pattern Detection for the full algorithm.
• If a pattern is found, present recommendation via AskUserQuestion:
  • Question: "检测到常用流程：[pattern]（已出现 N 次）。是否直接以 direct 模式运行 ppw:update？"
  • Options: "Yes, proceed" / "No, continue normally"
• If user accepts: set mode to direct, skip Ask Strategy questions.
• If user declines or AskUserQuestion unavailable: continue in normal mode.

Step 1: Pre-flight Check

• Verify gh CLI is available and authenticated: gh auth status
• Verify the upstream repo is accessible: gh api repos/Lylll9436/Paper-Polish-Workflow-skill --jq '.full_name'
• If either check fails, report the error and stop.
• Record workflow: Append {"skill": "ppw:update", "ts": "<ISO timestamp>"} to .planning/workflow-memory.json. Create file as [] if missing. Drop oldest entry if log length >= 50.

Step 2: Fetch Remote File Index

• List all skill directories from the remote repo:

  gh api repos/Lylll9436/Paper-Polish-Workflow-skill/contents/.claude/skills --jq '.[].name'
  

• List all reference files from the remote repo:

  gh api repos/Lylll9436/Paper-Polish-Workflow-skill/contents/references --jq '.[] | .name + " " + .type'
  

• For reference subdirectories (type=dir), also list their contents recursively.