Community写作与编辑github.com

noppu-labs/ai-toolkit

用于 Laravel 和 React 应用的智能体开发工具包

ai-toolkit 是什么?

此技能为开发者提供了将第三方技能与上游仓库同步的完整工作流程指南。它通过一个专用的 Node.js 脚本 (`scripts/skills-sync.mjs`),以状态驱动的方式管理技能同步,包括检查状态、拉取更新、接受本地修改以及处理分歧。该工具包支持 Laravel 和 React 应用的智能体开发,要求预先安装 GitHub CLI (`gh`) 并在代码库根目录下执行命令。当技能出现分歧时,技能详细说明了手动合并的注意事项和步骤,强调绝不能盲覆盖,必须先查看完整差异和提交历史,以在保留本地自定义修改的同时整合上游改进,最后重新设定基线。

兼容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add noppu-labs/ai-toolkit

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

将第三方技能与上游同步

前提条件:已认证 gh CLI。所有命令从代码库根目录执行。

工作流程

  1. 运行 node scripts/skills-sync.mjs status。状态及对应操作:

    • up-to-date — 无需操作。
    • local — 自有技能,无上游;无需同步。
    • upstream-updated — 安全快进:执行 node scripts/skills-sync.mjs pull <plugin>/<skill>。
    • locally-modified — 自上次基线后有过编辑。如果编辑是有意的, 执行 node scripts/skills-sync.mjs accept <plugin>/<skill>。
    • diverged — 两侧均有变更:手动合并(见下方章节)。
    • fetch-error (...) — 上游不可达或已移动;检查插件 skills-lock.json 中的 source/skillPath 与上游仓库。
  2. 所有更改完成后:执行 node scripts/skills-sync.mjs verify,然后提交并附带一条信息, 列出哪些技能被拉取或合并,以及来自哪些上游提交。

分歧技能的手动合并

切勿盲目覆盖分歧的技能 —— pull --force 会丢弃我们的自定义修改。

  1. node scripts/skills-sync.mjs diff <plugin>/<skill> — 显示完整的差异(第三方版本 → 上游版本)。
  2. 识别哪些差异是我们的有意自定义修改 (git log -p -- <plugin>/skills/<skill> 显示第三方副本的演变过程) 以及哪些是真正的上游改进。
  3. 编辑第三方文件,在保留每个本地自定义修改的同时整合上游改进。编辑前务必完整阅读两个版本。
  4. 重新设定两侧基线:node scripts/skills-sync.mjs seed <plugin>/<skill> (accept 仅重新设定第三方哈希的基线,会导致技能永久标记为上游已更新)。

相关技能