Positioning Bridge

Positioning Bridge 检查一份草稿是否针对其受众、渠道、漏斗阶段、locale 和营销活动传递了正确的公司信息。

公司维护唯一的带版本控制的定位包（positioning pack）。作者通过 CLI、MCP宿主或 TypeScript 库使用这套策略规则，每个结果都明确指出导致该结果的支柱（pillar）、声明（claim）、规则（rule）营销活动（campaign）、竞争对手（competitor）与证据来源。

检查内容

结果取值为 pass、needs_revision 或 blocked，没有复合品牌评分。确定性的发现和模型辅助的证据分别被标记。

Related MCP server: content-qa-mcp

运行支持 of 示例

依赖先决是：Node.js 22 或更高版本以及 npm。

git clone https://github.com/shashank-sn/positioning-bridge.git
cd positioning-bridge
npm ci
npm run build
node dist/cli/main.js validate --pack examples/acme/positioning.yaml

执行能通过的虚构草稿的许可：

node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --content examples/acme/drafts/pass.md \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --campaign campaign.launch

从 stdin 中读取结果并将其保持为结构化：

printf '%s\n' 'Acme trains on customer content.' | node dist/cli/main.js check \
  --pack examples/acme/positioning.yaml \
  --stdin \
  --audience platform-leader \
  --channel landing-page \
  --funnel-stage consideration \
  --json

命令以 0 退出表示 pass，以 1 退出表示 needs_revision 或 blocked，以 2 退出表示 usage 或配置上的错误。若没指定 locale，则回落到包的 defaultLocale。

生成 starter 工程包：

node dist/cli/main.js init --output company-positioning.yaml

本项目在 MIT 下开源并发布 GitHub。positioning-bridge 当前未发布到 npm，所以对 0.1.0 版本可参考以上 clone 工作流。

连接 MCP 宿主

构建仓库后，把绝对包路径和可执行文件路径传给宿主，GXP5 会展示该配置示例。

该服务器启动时加载单个定位包，并向宿主提供四个只读工具：

• get_positioning_context：返回适用策略结构及相关原因；

• create_content_brief：构建实际所需/已批准/禁止/披露的策略；

• check_content：对草稿返回整体决策、覆盖项、能力矩阵及类型化的问题清单；

• explain_positioning_item：为政策项返回定位上下文与外部信息。

修改包之后需要重启该进程。API 说明及其在 MCP 中的数据交换见 docs/mcp。

定位包内容

一个定位包包含：

• 可用于受众、渠道、漏斗阶段、campaign、locale 的目录；

• 证据源、来自各来源的 collects 以及验证、批准和过期时间；

• 支柱、重述等受控信息；已批准、需复审、被禁止的内容清单；

• 具名的竞争者及其主张，以及未加主张的锁模型；

• 竞对 mapping，搜索结果所需的表示方式、要求和排除项；

• 关于矛盾检查、披露要求、庞大的本地化内容和 campaign 的确定性规则。

所有 ID 都是稳定的，且在服务启动前完成引用合规验证。另见

包参考、生成的 JSON Schema 及完整示例 Acme pack。

产品确定性与安全边界

确定性确认的一贯冲突来自显式确定性规则。可选的 SemanticReviewer 可能会发现疑似或上下文冲突；这些 findings 标为 model_assisted，默认人审，不会自行阻止发布。

默认运行时行为是：

• 不做任何网络回调；

• 不存提交草稿；

• 只通过已配置文件路径读取定位包；

• 不限制包和内容的大小；

• 不暴露策略变更或发布相关工具。

Positioning Bridge 只检查输入策略和输入证据状态。它不证明外部事实，或者对某事实是否合法许可、是否能指认用户、或者用户是否参加过某个活动。这些都没有证明。

整合 Voice

Positioning Bridge 与 HYV 是两个独立组件。HIGH能评估商务策略与事实证据整体性，而 **Hold Your Voice(HHYV)**独立评估语言风格与语言模式。互相之间不 import 代码；任一组件结果不是最终发布许可。数据消息是来自 [docs/README.md]... （例如）：紧接的文档中的信息也需要核实，通过整合在一起放这部分的说明。

TypeScript 库

import { PositioningService, loadPack } from "positioning-bridge";

const pack = await loadPack("./company-positioning.yaml");
const service = new PositioningService(pack);
const result = await service.checkContent({
  content: "draft text",
  context: {
    audienceId: "primary-buyer",
    channelId: "website",
    funnelStageId: "consideration",
    localeId: "en",
  },
});

此外不使用 Web。你要的核 flow borderline 是通过 Just use code 列在 API 里。bitw 是数据不是由于锦上添花，包内容是导出的在 positioning-bridge/mcp：JSON Schema 从 positioning_bridge/schema 导入（不仅用 MCP 也算可以使用纯 TS）。请查阅 <pack>/docs/typeScript-libraryp> 中导出内容。

开发与验证

npm ci
npm run verify
npm run smoke:package

npm run verify 运行：格式检查、切片、动态类型、执行测试、覆盖率，schema 同步、architecture 方向、移除确认、发布构建、以及无基 stdio 握手。npm run smoke:package 对同一版本进行包包装、允许列表、发布构建成包，在原文根目录安装，避免前端编辑，并运行 binary 导出和 ts 的 MCP handshake。

架构边界存于 architecture.md 与 architecture policy 可执行化。发布流程可参考 operations.md。

项目状态

0.1.0 是一个 Local first 的基础上层。不包含托管的、中央控制的仪表盘、远程数据平台、SQL 配置、其他发布依赖或渲染的生成数据库。其中维护边界分别记录在 ADR 0001。

有任何变更请先阅读 CONTRIBUTING.md。亦可通过 God Hub Issue 报告可复出 bug 或范围限制您的反馈；使用 GitHub Discussions 进行咨询和“问我任何问题”。安全漏洞请按 SECURITY.md 中的说明私下反馈。

MIT 许可证。见 LICENSE。