PCP（项目上下文协议）

标准化上下文，而非智能。

一个项目上下文。每位贡献者。

PCP（项目上下文协议）是一个开放标准，用于保存、组织和传递项目上下文，使得任何贡献者——无论是人类、AI 还是自动化工具——都能一致地继续软件项目，无论接下来由谁或什么接手。

为什么选择 PCP？

软件项目每天都在丢失连续性。

知识停留在人们的头脑中。

重要决策消失在聊天记录里。

文档变得过时。

AI 助手因为项目上下文碎片化而不得不从头开始。

新贡献者花费宝贵时间重新发现已经存在的信息。

随着项目增长，上下文分散在文档、源代码、问题跟踪器、聊天和个人经验中。

PCP 的存在是为了保持项目连续性。

🚀 快速开始

📖 刚接触 PCP？ 阅读我们的实用入门指南：

• 🇹🇷 Türkçe Rehber (5 Dakikada PCP)

• 🇬🇧 面向 AI 开发者的 PCP 解释

Related MCP server: @context-anchor/mcp-server

⚡ 快速入门（CLI 和 MCP）

1. 在任何仓库中初始化上下文

npx @craftsolutions/pcp init --name "My Project"

2. 验证上下文完整性（Linter）

npx @craftsolutions/pcp check

3. 通过 MCP 连接到 AI 助手（Cursor / Claude / Antigravity）

将此添加到你的 IDE 的 MCP 配置中：

{
  "mcpServers": {
    "pcp": {
      "command": "npx",
      "args": ["-y", "@craftsolutions/pcp", "mcp"]
    }
  }
}

🔍 为什么选择 PCP 而非其他解决方案？

仓库指南

什么是 PCP？

PCP 定义了一个共享的项目上下文标准。

PCP 不是教每个 AI 系统你的项目如何工作，而是标准化项目本身周围的信息。

这使得：

• 人类

• AI 助手

• 自主代理

• 开发工具

• 未来的贡献者

能够基于对项目的相同理解进行工作。

核心理念

软件项目不应依赖记忆。

它们应依赖共享的上下文。

PCP 创建了一个单一的、结构化的项目上下文，能够经受住：

• 贡献者变更

• AI 模型变更

• 团队增长

• 长时间开发暂停

• 工具演变

一个项目。

一个上下文。

每位贡献者。

核心原则

• 上下文优于对话

• 连续性优于记忆

• 概念优于文件

• 默认开放

• 人类与 AI 协作

• 保存知识，而非重新发现

• 标准化上下文，而非工具

PCP 如何工作

Contributor
      │
      ▼
Project Context
      │
      ▼
Next Contributor
      │
      ▼
Project Continuity

每位贡献者从同一个项目上下文中读取。

每位贡献者离开项目时，上下文比他们发现时更好。

PCP 是什么

PCP 是：

• 一个开放标准

• 一个项目上下文协议

• 一种以连续性为先的软件开发方法

• 对人类和 AI 友好

• 技术无关

• 实现无关

PCP 不是什么

PCP 不是：

• 一个 AI 框架

• 一个代理框架

• 一个提示库

• 一个项目管理工具

• 一个文档平台

• 一个版本控制系统

• 一个知识库应用

PCP 标准化的是上下文，而非智能、工具或工作流。

参考实现

本仓库包含 PCP 的官方参考实现。

参考实现使用 Markdown 文档来演示规范定义的概念。

其他实现可以使用不同的文件格式、数据库或存储系统，只要它们保留了规范定义的必需概念。

规范定义概念。

参考实现演示实际实现。

仓库结构

docs/           Specifications and documentation
rfcs/           Design decisions and proposals
reference/      Official reference implementation
examples/       Example projects
assets/         Images and diagrams
scripts/        Development utilities

项目状态

⚠️ 活跃设计阶段

PCP 目前处于规范阶段。

优先事项是在开发工具和集成之前，建立稳定的概念基础。

路线图

• 完成 PCP 规范 v0.1

• 发布参考上下文模板

• 扩展示例项目

• 构建合规性验证器

• 开发 PCP CLI

• 发布 VS Code 集成

• 发布 MCP 集成

• 发布 PCP v1.0

愿景

我们相信软件项目应该能够继续，无论由谁——或什么——接手。

项目连续性不应依赖记忆。

它应依赖一个共享的、结构化的、可移植的项目上下文。

理念

不要保存对话。

保存上下文。

许可证

MIT 许可证。