Productboard Search

核心用法

本技能是 ProductBoard SaaS 平台的 API 封装集合，提供 8 个专用工具覆盖三大场景：

1. 全局与精准搜索

• pb_search：跨实体全局搜索（功能、产品、反馈）
• pb_feature_search：按关键词检索功能点

2. 产品架构管理

• pb_product_hierarchy：展示完整产品-组件树状结构
• pb_product_get / pb_product_list：查看产品详情与列表
• pb_feature_list / pb_feature_get：按状态/产品/组件筛选功能，获取详细信息

3. 客户反馈洞察

• pb_note_list：浏览用户反馈笔记，支持日期过滤

显著优点

• 官方 API 集成：直接对接 ProductBoard，数据实时同步
• 结构化探索：从宏观产品层级到微观功能状态，逐级钻取
• 多维度过滤：支持按状态（new/in-progress/shipped/archived）、时间、组件等 6+ 条件组合筛选
• 零配置即用：无需复杂认证流程，调用即返回带链接结果

潜在局限

• 依赖外部 SaaS：需有效 ProductBoard 订阅及 API 权限
• 只读为主：目前工具集以查询、检索为核心，无创建/编辑功能
• 结果集限制：未明确分页机制，大规模数据可能需要多次调用

适合人群

• 产品经理：快速定位功能需求、梳理产品架构
• 客户成功团队：检索用户反馈，关联到具体功能改进
• 研发团队：了解功能状态与组件归属

常规风险

• API 速率限制可能导致高峰期调用受限
• 敏感产品路线图数据通过第三方中转，需确认数据驻留合规
• 客户反馈可能包含 PII，检索时需注意数据脱敏

核心用法

ProductBoard Search Skill 是一款专为产品经理团队设计的智能检索工具，通过与 ProductBoard 平台深度集成，实现对产品工作空间的全面搜索能力。该技能提供七大核心工具：全局搜索（pb_search）、功能列表检索（pb_feature_list）、功能详情获取（pb_feature_get）、功能关键词搜索（pb_feature_search）、产品目录查询（pb_product_list）、产品详情与组件查看（pb_product_get）、产品层级结构浏览（pb_product_hierarchy）以及客户反馈检索（pb_note_list）。

用户可通过多种策略高效定位信息：按关键词搜索功能特性、按产品或组件 ID 筛选、按状态（new/in-progress/shipped/archived）过滤进度、按日期范围检索客户反馈。建议新用户优先使用 pb_product_hierarchy 了解工作空间架构，再结合具体工具深入探索。

显著优点

零代码安全风险：该技能为纯 Markdown 文档型 Skill（T-MD 分类），不含任何可执行代码，从根本上杜绝了代码注入、恶意执行等安全隐患，企业部署零顾虑。

权限最小化原则：仅申请 ProductBoard API 的只读权限，不涉及数据写入、修改或删除操作，最大程度保护客户反馈和产品数据安全。

搜索体验优化：支持大小写不敏感搜索、部分匹配、结果直链跳转，大幅降低产品经理的信息检索成本。

结构清晰易懂：内置完整的产品层级浏览能力，帮助团队快速理解复杂的产品-组件-功能关系，特别适合多产品线企业。

潜在缺点与局限性

来源可信度待提升：维护者为 GitHub 个人开发者（T3 级别），尚未积累大量社区 Stars 或企业背书，长期维护稳定性存在不确定性。

功能边界明确：仅限搜索和浏览，无法执行创建、编辑、状态更新等操作，重度用户仍需返回 ProductBoard 原生界面完成管理工作。

API 依赖风险：功能完全依赖 ProductBoard API，若官方接口变更或弃用，技能可能失效，需关注平台更新动态。

许可证信息缺失：当前未声明开源许可证，企业合规审查时可能遇到障碍。

适合的目标群体

• 产品经理：需要快速检索历史功能、客户反馈以支持决策
• 产品运营：定期汇总特定主题的用户反馈和需求
• 研发团队负责人：了解产品架构和功能分布，协调开发优先级
• 新入职成员：快速熟悉公司产品线结构和历史需求

使用风险与注意事项

性能层面：大规模工作空间的全局搜索可能响应较慢，建议优先使用带过滤条件的专用工具（如 pb_feature_list）而非宽泛搜索。

数据隐私：虽然技能本身仅只读访问，但用户需确保 Agent 配置的产品 API Token 权限范围适当，遵循最小权限原则。

长期维护：建议企业用户 fork 仓库自行维护，或监控原仓库更新，以应对潜在的 API 变更或服务中断。

合规建议：在正式使用前，建议企业安全团队审核 API Token 申请范围，并确认 ProductBoard 数据处理符合公司数据治理政策。