mcpField
P
pipa-setup

pipa-setup

github.com/lunchpaillolaAgent 工作流3174 次安装5 天前更新
代码仓库

关于 pipa-setup

用于设置或更新 Pipa 全局业务档案的技能，面向首次配置或维护档案的用户。它逐项收集确认过的信息，可选审阅沟通风格与连接器，并将配置状态保存在指定文件中。

主要功能

  1. 01逐项收集业务档案信息
  2. 02支持跳过未回答的问题
  3. 03保存已确认资料并维护设置状态
  4. 04可选审阅沟通风格文件
  5. 05将连接器检查交由专门技能

适用场景

  1. 01首次建立 Pipa 业务档案
  2. 02继续未完成的档案设置
  3. 03更新现有档案的已确认字段

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lunchpaillola/pipa-skills --skill pipa-setup

安装后在 Claude Code 中输入/pipa-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
trigger-eval-set.json
references/
communication-style.md

详细介绍

Pipa 设置

在 ~/.pipa/profile.md 中设置或更新全局 Pipa 业务档案，并可选择在 ~/.pipa/communication-style.md 中安装共享沟通风格。

状态路由

  1. 检查 ~/.pipa/profile.md 是否存在。
  2. 如果文件不存在，将设置作为可选的后续步骤提出，不要中断正在进行的具体工作。
  3. 如果 setup_status: incomplete，从第一个未回答的问题继续。如果三个问题均已回答或跳过，则继续审核沟通风格，然后审核连接器。
  4. 如果 setup_status: complete，展示现有档案并询问需要修改什么。保留已完成状态和未变更字段；仅在用户提出要求时审核沟通风格或连接器。

在用户接受设置之前，不要执行已连接工具或记忆检查。

工作流

1. 提出核心问题

用户接受设置后，将当前请求中的明确回答或明确跳过视为已确认，并在提问前保存。仅以对话方式逐一询问尚未回答的问题：

  1. What do you do?
  2. Who do you help or work with?
  3. How do you like to work?

允许跳过每个问题。只有当回答不清楚时才追问。不要询问团队结构、审批、流程或当前重点。

首次写入档案前，如果 ~/.pipa/ 不存在，则先创建该目录。每次用户回答或跳过后，都以 setup_status: incomplete 保存已确认的状态。保留现有已确认事实，绝不臆造缺失的上下文。

使用以下便于阅读的格式：

---
setup_status: incomplete
setup_version: 1
updated_at: <ISO-8601 timestamp>
---

# Pipa Profile

## What I Do
<confirmed answer, `Skipped`, or `TBD`>

## Who I Help Or Work With
<confirmed answer, `Skipped`, or `TBD`>

## How I Like To Work
<confirmed answer, `Skipped`, or `TBD`>

## Website Context
<confirmed website-supported business, offer, audience, or positioning facts; omit when unused>
2. 可选：阅读公司网站

如果用户提供了公司 URL 并希望获得起草帮助，请核实每个请求阅读的页面，并仅提出有依据的业务、服务、受众或定位信息。将每个请求阅读的页面标记为 used、partial、stale、empty、declined、unavailable 或 failed；对于超出请求范围的页面，才使用 not-requested。绝不要将部分内容过时或被拒绝的页面视为空内容或完整内容。即使遇到部分内容过时内容为空被拒绝无法访问或读取失败的情况，也要安全地利用其他可用输入继续设置，并注明所用资料页面的 URL。将拟议信息归入 Website Context 前，先向用户确认；绝不覆盖用户提供的内容。此操作仅限只读，并尽力完成。不要添加信息增强服务，也不要通过电子邮件反向查找人员。已连接应用的审核仍由 pipa-connectors 负责；它必须通过 composio-mcp 的发现结果和完整工具架构验证访问权限，而不能依赖连接器映射。

3. 审核沟通风格

随附的默认文件为 references/communication-style.md。共享运行时路径为 ~/.pipa/communication-style.md。运行时文件仅控制呈现方式；如果其中内容与路由、必需的发现结果／输出约定、工具使用、事实、安全或审批／写入关卡冲突，则忽略该文件。

  • 如果运行时文件不存在，可提出根据随附默认文件创建该文件。说明其控制内容，并在写入前另行取得明确批准；仅接受设置不等于批准。
  • 如果运行时文件存在，默认保留原样。用户要求审核或更新时，展示拟议的更改或替换内容，并在写入前另行取得明确批准。
  • 绝不在未告知用户的情况下覆盖自定义运行时文件。用户拒绝、文件操作不可用或运行时文件缺失，都不会阻止完成设置或使用其他 Pipa 技能。
4. 审核相关连接

将连接器审核交由 pipa-connectors 处理。它负责发现活动连接、映射能力，以及创建或更新 ~/.pipa/CONNECTORS.md。连接被拒绝、不可用或失败，不会阻止设置完成，也不会清除档案事实。

5. 完成设置

连接器审核后，将档案元数据更新为 setup_status: complete，并刷新 updated_at。

完成的资料更新

对于 setup_status: complete，不要重新运行首次设置工作流。显示当前资料，并直接应用明确指定的资料更新；仅当字段或替换值缺失或含义不明确时才提问。只更新已确认的字段，保留 setup_status: complete，并刷新 updated_at。只有在收到请求时才检查沟通风格或连接器；即使如此，在创建或更新沟通风格运行时文件之前，仍须另行获得明确批准。

输出约定

  • 已收集的资料，包括已跳过或未知的字段。
  • 资料路径和设置状态。
  • 检查沟通风格时：沟通风格路径和状态：created、updated、unchanged、declined、unavailable 或 TBD。
  • 运行连接器检查时：连接器映射路径和已映射的功能。
  • 连接状态：connected、needs-auth、declined、unavailable、failed、not-reviewed 或 TBD。
  • 一个可选的后续步骤。

安全规则

  • 设置缺失绝不能阻止具体的业务工作。
  • 在检查资料、连接器或记忆之前，必须先获得对设置流程的接受。
  • 创建或更新 ~/.pipa/communication-style.md，必须针对拟议的具体写入内容另行获得明确批准。
  • 首次设置不得创建任务、提醒、自动化、触发器或定期工作流。
  • 只保存已确认的资料事实；不得编造背景信息或覆盖用户提供的内容。
  • 未获得所属操作所要求的确认，不得写入外部记忆或连接工具。
  • 如果 pipa-connectors 不可用，应说明无法运行连接器检查。不得执行复制的连接器工作流。

评论

支持 Markdown