Agent Skills › szw321127/repowise › pk-auto-crystallize

pk-auto-crystallize

GitHub

用于任务结束时自动提炼项目知识，通过脚本分析任务上下文、文件变更及推荐匹配，生成实践节点并更新知识库。

plugins/pk/skills/pk-auto-crystallize/SKILL.md szw321127/repowise

Trigger Scenarios

用户希望自动总结任务经验需要更新项目知识库实践

Install

npx skills add szw321127/repowise --skill pk-auto-crystallize -g -y

More Options

Non-standard path

npx skills add https://github.com/szw321127/repowise/tree/main/plugins/pk/skills/pk-auto-crystallize -g -y

Use without installing

npx skills use szw321127/repowise@pk-auto-crystallize

指定 Agent (Claude Code)

npx skills add szw321127/repowise --skill pk-auto-crystallize -a claude-code -g -y

安装 repo 全部 skill

npx skills add szw321127/repowise --all -g -y

预览 repo 内 skill

npx skills add szw321127/repowise --list

SKILL.md

Frontmatter

{
    "name": "pk-auto-crystallize",
    "description": "Use when the user wants task-end project knowledge crystallization to be inferred from the current task, touched files, and existing recommendation matches."
}

PK Auto Crystallize

Treat this skill as the preferred task-end entrypoint when the user wants the project knowledge loop to update with minimal manual JSON authoring.

Required Behavior

Determine the target project root from an explicit path; otherwise use the current working directory.
Resolve ../../scripts/pk-auto-crystallize.mjs relative to this SKILL.md file.
The wrapper delegates to auto-crystallize-session.mjs.
If .project-knowledge/project-profile.md is missing, return mode: no-knowledge and skip crystallization entirely; do not scan touched files, create sessions, or create .project-knowledge/.
Prefer passing a JSON input file after the project path when the task summary, touched files, or session id are known.
If adoptedNodeIds is omitted, allow the script to infer adopted recommended options from pk-preflight matches.
Prefer explicit touchedFiles; allowGitStatusFallback must be true before dirty git status is used as low-confidence evidence.
Accept taskId or taskDir for generic task/process context. Prefer .tasks/<taskId> or tasks/<taskId>; compatible external workflow layouts such as .trellis/tasks/<taskId> are fallback inputs only. Treat process files as process sources and task text, not durable source evidence unless the project evidence policy explicitly allows them.
If incubatingNodes is omitted and no practice matches, allow the script to create an incubating practice plus candidate option from taskText and touchedFiles.
Report the result in Chinese and include mode, inferred adopted nodes, generated incubating nodes, touched files, task/process sources when present, and the next suggested skill pk-lint; when skipped because knowledge is uninitialized, suggest pk-init instead.

JSON Input Shape

{
  "sessionId": "session-YYYY-MM-DD-topic",
  "title": "本轮任务标题",
  "topic": "本轮任务主题",
  "taskText": "用于匹配已有实践的任务描述",
  "taskId": "",
  "taskDir": "",
  "decisionSummary": "一句话总结本轮关键决策。",
  "touchedFiles": [],
  "allowGitStatusFallback": false,
  "adoptedNodeIds": [],
  "rejectedNodeIds": [],
  "incubatingNodes": [],
  "stableUpdates": []
}