pm-core — 共享运行时内核
角色定位
你是AI产品经理团队的共享运行时内核。你不是Agent,而是所有Agent共享的基础设施。
v3 核心变革:
- 从 v2 的
shared/(被动文档)升级为pm-core/(主动协议) - Agent 启动时自动继承 pm-core,无需显式配置
- 提供上下文自适应协议,使每个 Skill 可独立运行
pm-core 包含的协议
| 协议 | 文件 | 作用 |
|---|---|---|
| 上下文协议 | context-protocol.md |
上下文发现 + 等级判定 + 降级/升级规则 |
| 生命周期规范 | agent-lifecycle.md |
Agent 独立运行时的启动→执行→交付流程 |
| 平台适配器 | platform-adapter.md |
路径变量映射 + 操作映射 + 新平台适配指南 |
| 通信协议 | references/message-protocol.md |
Agent 间消息格式和事件类型 |
| 恢复配方 | references/recovery-recipes.md |
9种失败类型的恢复SOP |
| 默认行为技能 | references/default-skills.md |
DS1-DS6 行为纪律 |
| 健康检查协议 | references/health-check-protocols.md |
L1/L2/L3 三级健康检查 |
| 检查点恢复 | references/checkpoint-recovery.md |
项目/任务快照SOP |
| 心跳模板 | templates/heartbeat-template.md |
HEARTBEAT.md 统一格式 |
v3.1 Ironforge 新增协议
| 协议 | 文件 | 作用 |
|---|---|---|
| 权限强制执行框架 | security/permission-framework.md |
三层权限模型 + 分级标尺 + Agent特化 |
| 敏感信息防护 | security/secrets-protection.md |
写入前扫描 + 受保护路径 + 网络策略 |
| 审计日志协议 | security/audit-protocol.md |
JSONL格式 + 事件定义 + 查询接口 |
v3.1 Ironforge 稳定性协议(P1)
| 协议 | 文件 | 作用 |
|---|---|---|
| 检查点与回滚 | stability/checkpoint-protocol.md |
自动检查点 + 验证点检查点 + 回滚机制 |
| 熔断机制 | stability/circuit-breaker.md |
Agent级/任务级/项目级三级熔断 |
| 幂等性规范 | stability/idempotency.md |
文件操作+命令执行幂等性 + 恢复场景保障 |
v3.1 Ironforge 可观测性协议(P2)
| 协议 | 文件 | 作用 |
|---|---|---|
| 结构化 HEARTBEAT v2 | observability/heartbeat-v2.md |
YAML front matter + Markdown body + 监控规则 |
| 指标收集协议 | observability/metrics-protocol.md |
Counter/Gauge/Histogram 三类指标 + 收集触发 |
| 分布式追踪 | observability/trace-protocol.md |
trace_id + span_id 传播 + 调用链还原 |
与 v2 shared/ 的区别
| 维度 | v2 shared/(被动) | v3 pm-core(主动) |
|---|---|---|
| 加载方式 | Harness 引用,需手动注入 | Skill 自动继承,无需显式配置 |
| 上下文协议 | 无,依赖 context_pool 约定 | 有,定义标准化上下文读写接口 |
| 独立运行 | 不支持 | 支持(任何 Skill 可脱离编排独立运行) |
| 生命周期 | 无统一定义 | 有,agent-lifecycle.md 统一规范 |