SuperAPI AI 工具集

pillar-best-practices

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

用途:为在 Web 应用中集成 Pillar SDK 与 CLI 提供最佳实践参考,适用于新项目接入、工具同步、知识源管理、集成问题诊断,以及在 React/Next.js 中添加 AI 助手面板。

主要能力:CLI 侧可用 pillar init 完成框架检测、SDK 安装、凭据生成与首次同步;pillar sync --scan ./src 推送工具定义,开发与 CI 可用 --watch;pillar knowledge 管理文档与帮助内容;pillar doctor 检查集成健康;pillar chat 可在不启动应用时测试助手;pillar auth 管理认证。SDK 侧要求用 PillarProvider 包裹应用,Next.js App Router 需 'use client' 包装组件,React 中用 usePillarTool 自动注册与清理,非 React 可用 pillar.defineTool()。

使用要点:工具描述需具体且可被 AI 匹配;inputSchema 遵循跨模型规则(数组需 items,不支持类型联合);execute 返回扁平数据而非仅 { success: true };用 guidance 字段消歧与说明前置条件;破坏性操作使用 needsConfirmation 或 renderConfirmation;交互 UI 用 type: 'inline_ui' 配合 render 与 sendResult;表单类工具延迟到用户提交;创建新工具前先审计语义重叠,并按能力拆分大工具。

适用场景:React/Next.js 应用中的 AI 助手面板、工具注册与多工具工作流设计、知识源接入。

限制:资料未提供具体版本要求、平台兼容范围、收费与价格信息,也未给出效果数据;详细说明与代码示例需查阅各 rules 目录下的规则文件。环境变量使用 PILLAR_SLUG 与 PILLAR_SECRET,凭据存放于 ~/.pillar/config.json。