PAIUpgrade

自定义

执行前，请检查以下位置是否存在用户自定义内容： ~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PAIUpgrade/

如果此目录存在，请加载并应用其中的任何 PREFERENCES.md、配置或资源。这些内容优先于默认行为。如果此目录不存在，则使用技能默认设置。

🚨 强制要求：语音通知（执行任何操作前必须完成）

调用此技能时，必须先发送此通知，然后才能进行其他操作。

1. 发送语音通知：

   curl -s -X POST http://localhost:31337/notify \
     -H "Content-Type: application/json" \
     -d '{"message": "Running the WORKFLOWNAME workflow in the PAIUpgrade skill to ACTION"}' \
     > /dev/null 2>&1 &
   

2. 输出文本通知：

   Running the **WorkflowName** workflow in the **PAIUpgrade** skill to ACTION...
   

PAIUpgrade

主要目的： 通过了解用户的上下文并发现生态系统中的新动态，为 PAI 生成按优先级排序的升级建议。

此技能运行 四个并行 Agent 线程，汇总生成个性化建议：

• 线程 0 — 既有工作审查（算法、PATTERNS.yaml、钩子、技能、近期 ISA、KNOWLEDGE、反馈记忆）
• 线程 1 — 用户上下文（TELOS、项目、近期工作、PAI 状态）
• 线程 2 — 来源收集（Anthropic、YouTube、自定义来源、GitHub 热门内容）
• 线程 3 — 内部反思（algorithm-reflections.jsonl）

线程 0 是防护机制，避免推荐已经实现、研究后决定暂缓或已决定不采用的内容。 综合分析时，必须通过线程 0 的状态清单筛选每一项候选建议——绝不能在未分配“既有状态”的情况下给出建议。

工作流路由

工作流	触发语句	文件
Upgrade	“check for upgrades”“check sources”“any updates”“check Anthropic”“check YouTube”“upgrade”“pai upgrade”	Workflows/Upgrade.md
MineReflections	“mine reflections”“check reflections”“what have we learned”“internal improvements”“reflection insights”	Workflows/MineReflections.md
AlgorithmUpgrade	“algorithm upgrade”“upgrade algorithm”“improve the algorithm”“algorithm improvements”“fix the algorithm”	Workflows/AlgorithmUpgrade.md
ResearchUpgrade	“research this upgrade”“deep dive on [feature]”“further research”	Workflows/ResearchUpgrade.md
FindSources	“find upgrade sources”“find new sources”“discover channels”	Workflows/FindSources.md
TwitterBookmarks	“check bookmarks”“scan bookmarks”“twitter bookmarks”“X bookmarks”“bookmarks for upgrades”“what have I bookmarked”	Workflows/TwitterBookmarks.md

默认工作流： 如果用户只说“upgrade”或“check for upgrades”，未提供具体说明，则运行 Upgrade 工作流（该工作流包含线程 3 的反思挖掘）。

输出格式

规范说明： References/OutputFormat.md——章节顺序、“既有状态”图例、表格列和硬性规则的唯一可信来源。本技能和 Workflows/Upgrade.md 均引用此文件，而不是各自重复编写这些内容。

章节顺序：发现 → 建议 → 技巧详情 → 内部反思 → 总结 → 已跳过 → 已处理的来源。

仅输出非空的建议级别（不要输出空的 🟡 MEDIUM 标题）。

提取规则

提取，不要总结。关注技术，而非建议。提出建议前先核实现有状态。

1. 每个输出项都必须是一项技术——具体的模式、代码片段、配置或方法。
2. 引用或用代码块呈现实际内容——准确展示原文。
3. 映射到 PAI 组件——每项技术都必须关联到特定文件、技能、工作流或系统组件。
4. 核实现有状态（Thread 0 门控）——在输出任何建议之前，先对照 Thread 0 清单核实：该内容是否已存在于 Algorithm、PATTERNS.yaml、钩子、SKILL 文件、KNOWLEDGE 或先前的 ISA 中？分配一个「先前状态」表情符号并引用证据。标记为 ✅ DONE 的项目应放入「已跳过」，而不是「建议」。
5. 必须包含两个描述字段，每个不超过 2 句话，内容具体明确：
   • **内容是什么：**技术本身——它的作用、工作方式及提供的能力
   • **对 PAI 有何帮助：**具体收益——改善哪个组件、填补什么缺口
6. 提供实现方式——展示修改前后的代码或具体步骤。
7. 跳过，不要稀释内容——如果内容没有可提取的技术，就说明原因并将其放入「已跳过的内容」。

来源类型标签：

标签	含义
GitHub: claude-code vX.Y.Z	特定版本的发布说明
YouTube: Creator @ MM:SS	带时间戳的视频
Docs: Section Name	文档章节
Blog: Post Title	博客文章

配置

技能文件：

• sources.json — Anthropic 来源配置（30 多个来源）
• youtube-channels.json — 基础 YouTube 频道（默认为空）
• State/last-check.json — Anthropic 状态
• State/youtube-videos.json — YouTube 状态
• State/github-trending.json — GitHub 趋势状态（已查看的仓库）
• State/twitter-bookmarks-seen.json — 先前处理过的书签 URL

用户自定义项（~/.claude/PAI/USER/SKILLCUSTOMIZATIONS/PAIUpgrade/）：

• EXTEND.yaml — 扩展清单
• youtube-channels.json — 用户个人 YouTube 频道
• user-sources.json — 其他来源定义（例如 github_trending 区块）

工具参考

工具	用途
Tools/Anthropic.ts	检查 30 多个 Anthropic 来源（博客、GitHub 仓库、变更日志、文档）是否有更新

核心原则

1. 提取，不要总结——提取具体技术，绝不能只链接到来源。
2. 引用来源——引用实际代码、文档原文或转录片段。
3. 结合 PAI 上下文——每项技术都映射到特定的 PAI 文件、技能或组件。
4. 说明「与你有何关系」——「这会有所帮助，因为你当前的 [X]……」
5. 关联 TELOS——说明相关性时，引用用户的目标和挑战。
6. 果断跳过——如果内容没有可提取的技术，就完全跳过。
7. 可直接实现——提供实际代码修改，而不是含糊的建议。
8. 通过 claude-code-guide 确保 Claude Code 信息最新——如果发现涉及 Claude Code 内部机制（钩子、设置、斜杠命令、MCP、Agent 类型、键位绑定、Agent SDK、Claude API），则启动 Agent(subagent_type="claude-code-guide")，以核实 PAI 当前的参考资料是否与最新 API 接口一致。

反模式（不要输出的内容）

以下输出模式属于失败：

❌ 错误输出	错误原因	✅ 正确输出
"Check out R Amjad's video on Claude Code"	只是指向内容，没有提取内容	"@ 5:42，R Amjad 展示了这项技巧：[引用]"
"v2.1.16 has task management improvements"	总结含糊，没有说明技巧	"v2.1.16 新增了 addBlockedBy 参数：[代码示例]"
"Consider looking into MCP updates"	只有建议，没有提取内容	"MCP 现已支持[具体功能]：[文档引用]"
"This could be useful for your workflows"	相关性含糊	"这能改善你的 Browser 技能，因为它弥补了[具体缺口]"
"Several videos covered AI agents"	只有数量，没有具体内容	"[N] 个视频已跳过——没有可提取的技巧"
"This helps because it improves things"	好处含糊	"对 PAI 有何帮助：SecurityValidator 目前只会阻止命令。additionalContext 能在工具执行前提供推理上下文，让决策更加细致。"
"A new hook feature"	没有描述它是什么	"功能说明：PreToolUse 钩子可以返回 additionalContext，并在执行前注入模型上下文，从而支持基于推理的决策，而不是简单地二元阻止。"
"Top 3 Actions" 或没有分级的建议列表	没有优先级层级	建议部分应包含 🔴/🟠/🟡/🟢 等级，并为每个等级设置 PAI Relevance 列
将建议放在底部	可执行事项被埋在技巧列表之后	🔥 建议部分应排在第二，技巧详情排在第三
建议实施已有的功能	浪费用户的信任	将其移至 Skipped，并提供文件:行号证据
在没有新背景的情况下重新提出已被否决的想法	偏离先前的决定	仅在原因发生变化时重新提出；说明发生了什么变化
缺少 Prior Status 列	绕过 Thread 0 门槛	每条建议都必须引用 Thread 0 清单中的证据

**检验方法：**如果别人说“给我看看这个技巧”，而你拿不出任何内容，那就说明你失败了。

工作流

• Upgrade.md — 主要工作流；包含完整的四线程分析及分级建议
• MineReflections.md — Thread 3 独立工作流（深度反思挖掘）
• AlgorithmUpgrade.md — 专注于算法版本升级的升级流程
• ResearchUpgrade.md — 深入研究具体的升级机会
• FindSources.md — 发现并评估要监控的新来源

注意事项

• 并行检查所有来源——Anthropic 博客、变更日志、YouTube 频道、GitHub 发布记录。不要按顺序逐一检查。
• 升级不得破坏现有技能或工作流。 应用前先验证向后兼容性。
• 完整升级检查可能需要 5-7 分钟。 对外层 Agent 使用 run_in_background: true。

执行日志

完成任何工作流后，追加一条 JSONL 记录：

echo '{"ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","skill":"PAIUpgrade","workflow":"WORKFLOW_USED","input":"8_WORD_SUMMARY","status":"ok|error","duration_s":SECONDS}' >> ~/.claude/PAI/MEMORY/SKILLS/execution.jsonl

将 WORKFLOW_USED 替换为所执行的工作流，将 8_WORD_SUMMARY 替换为简短的输入描述，并将 SECONDS 替换为大致的实际耗时。如果工作流失败，将 status 记录为 "error"。