pnCore — v0.18.7

pnCore 是一个 MCP 服务器和 Cursor 插件。它把软件交付变成一系列已命名、带门控的步骤来运行，而不是一次漫长的聊天。

它通过确定性的 workflow_step 引擎交付 discovery、规划、skeptic 挑战、设计、审计、素材和交付 —— 由 skills、agents、rules 和 pn-core:// 资源驱动，而不是靠在纯提示词文件夹来实现。

目录： 170 个技能、9 个公开 agents + 6 个内部编排 agents、31 个可见的斜杠命令面板文件（30 个位于 pn 子菜单 + /pn 占位文件）+ 18 个面板隐藏的精准命令（总命令文件 49 个）、26 个 MCP 工具、16 种工作流类型，以及 pn-core:// 资源和提示词。

它为什么存在

一个普通聊天可以规划功能、写完代码，然后告诉你“做好了”——但中间没有任何检查点。若在第 3 步出了偏差，你只能重读整个对话记录来定位问题。让它重做任何一部分，往往意味着从头开一段新聊天，此前一路支撑到这里的上下文已经没了。

pnCore 把这些步骤列表从聊天里挪了出来。workflow_step(type, index, state) 一次只执行一步——discovery、plan、build、review——并交回下一步的指令。某一步是否真的通过，由 skeptic 检查、人关卡或 workflow_verify 来判断，而不是模型自己说了算。就算中途断线，也可以 workflow_state_save 和 workflow_state_load，把 run 从断点接回来。

Related MCP server: odin

它是什么

确定性执行。 workflow_step(type, index, state) 决定下一步指令。步骤不会被绕过——每跳过一步都会由更严谨的关卡决策并记录在状态里。

门禁机制。 skeptic、人工、以及 workflow_verify 关卡被直接内置在引擎中。意图可以是 full auto、design focused 或 involved —— 若是 involved，discovery、plan、specialists 和 review 必须在正式运行前经受你的批准。

多端一致。 唯一可信的正文内容，是 packages/pn-core-mcp/content/。出来一个来源，MCP 在任意客户端都能跑引擎；Cursor 插件则提供 / 面板、文件呢 glob 规则、代理选择器和 stop hook；Pi 原生注册了同一套 26 个工具。

可恢复。 每次 run 都带一个 run_id。交接命令和用量记录写入 JSONL。断开连接后，加载状态即可继续原来的步骤列表。

安装

前提条件： Node.js 22 或更高版本。

先调用 health —— 它应当返回 version、calendarDateUtc 和 capabilities。如果一个都没有 health，那么下游东西（skills、agents、workflow_step）也不会加载了。

Cursor — MCP（一键安装）

[](https://cursor.com/en/install-mcp?name=pn-core\\\\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi0tcGFja2FnZT1naXQraHR0cHM6Ly9naXRodWIuY29tL3Blcm5pZW1hbm4vcG5Db3JlLmdpdCNtYWluIiwiLS0iLCJwbi1jb3JlIl0sImVudiI6eyJHSVRfVEVSTUlOQUxfUFJPTVBUIjo wMCIsIkdJVF9BU0tQQVNTIjoiZWNobyJ9fQ==)

或者手动添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "pn-core": {
      "command": "npx",
      "args": ["-y", "--package=git+https://github.com/perniemann/pnCore.git#main", "--", "pn-core"],
      "env": { "GIT_TERMINAL_PROMPT": "0", "GIT_ASKPASS": "echo" }
    }
  }
}

GIT_TERMINAL_PROMPT=0 与 GIT_ASKPASS=echo 用于在 git 无法验证身份时（凭据缺失、限制触发率、或 URL 错误）快速失败。没有这两项，当 stdin 由管道供入时，凭据提示会被卡住，让 Cursor 永远停在加载状态中。

Cursor — 插件

在你的目标项目目录下：

npx github:perniemann/pnCore plugin-install

会把命令、规则、技能、agents、配置和钩子复制到 .cursor/ 和 .cursor-plugin/。重启 Cursor 之后，运行 /pn-new。

到底用哪个 —— MCP 还是插件？ MCP 是引擎；插件是 Cursor 界面层（斜杠命令面板、rules、agents、stop hook）。推荐的 Cursor 组合是二者一起装。详见：插件和 MCP 区别。

pi.dev（Pi coding agent 界面）

pi install git:github.com/perniemann/pnCore@main

Pi 暴露统一的 /pn 入口。直接调用： /pn pn-build。原生工具通过 pi install git:…/pnCore 打包，或在安装 pi install . 前从仓库根目录执行一次 npm run build:mcp 也会带上。Cursor 和 Claude Code 还是走标准的 stdio MCP 协议。参见 ADR-0008 与 ADR-0009。

Claude Code

方式与上面的 MCP JSON 相同：Settings → MCP Servers，粘贴配置并启用。具体参阅 Anthropic 官方 MCP 文档。

Windows、Cloud Agents、checkout 下的裸 node 路径、首跑 npx 超时类问题：转 packages/pn-core-mcp/README.md。克隆开发：CONTRIBUTING.md。

快速开始

1. 先装 MCP 或插件（步骤见上）。

2. 调用 health —— 拿到版本、UTC 日期、capabilities。

3. 新仓库或全新项目： 执行 /pn-new 或 workflow_step("project_kickoff", 0, {}) —— 生成 discovery、refs、PRD 与设计文档，存放于 docs/refs/ 下。

4. 构建或扩展： 执行 /pn-build 或 workflow_step("full_dev", 0, {}) —— 已有一定上下文的项目可跳过 kickoff。

5. 交付前： 运行 /pn-deliver，或先跑 /pn-frontend-audit。

直接复制粘贴这条消息：

pn-new ▲

Build [your-project-name] — [one-line description].
References: [path or "in .ref/"] (pitch, requirements, design assets).
Analyze both: prior art and design.
Intent: Involved — full gates at discovery, plan, specialists, and review.
Delivery tier: full. Design ambition: distinctive.

回答第 0 步：Yes、全部选；第 1 步：(3) 选“Involved”。

更多 prompt：见 how-to-use-guide。

工作流

调用 list_workflow_types 可得到各工作流当前的种步骤数量。

引擎还有：visual_tweak、prompt_optimize、game_feature、engine_feature（Unreal / Godot）、fsi_analyst_draft、media_director。完整列表及别名：list_workflow_types。

范例：full_dev

工具步骤索引起点为 0。断线后需要续跑：先 workflow_state_save，再 workflow_state_load。相关 schema：pn-core://reference/workflow-state-schema.md.

设计优先： 用 workflow_step("design", 0) 替代 full_dev。后续通过 /pn-setup 加载 .pncore-design.md。

游戏 / 3D： 写特性循环用 workflow_step("game_feature", 0)；需要全量构建就仍走 full_dev，并在 discovery 里声明技术栈。

变化是什么

三个递进阶 (delivery tier / context tier / model tier)：请勿把三者混用——delivery tier 仅指 MVP/Full，context tier（分级 1–4 指阅读上下文深度），model tier 则细分 fast / standard / premium / premium_thinking / long_horizon。带 role: orchestrator 的 suggest_model_tier 会给出 long_horizon。详见 pn-core://reference/delivery-tier-criteria.md 和 MCP 工具列表。

构建会话前请加载：pn-core://reference/best-practices.md、pn-core://reference/loop-orchestration-guide.md、pn-core://reference/aesthetics-baseline.md，以及当前 UTC 日期的 health。

诚实边界

最适合： 使用 Cursor，基于 React、Astro、Next.js、原生 Web、Node 后端、Three.js / Babylon / 游戏开发、n8n 与 web3 构建的团队。详见：docs/plugin-reference.md。

文档

脚本

贡献者脚本、本地 MCP 配置，以及如何开发 pnCore，详见 CONTRIBUTING.md。仓库布局：docs/folder-structure.md。

许可证

MIT — 详见 LICENSE。