⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
pm-analyst
|
Use with your AI agent
Open your project in any AI assistant that can read your files. Works with ChatGPT, Claude, Claude Code, Codex, Cursor, Hermes Agent, OpenClaw, Grok Bot, and more.
Your agent needs access to this page’s linked instructions and your project files. Copying does not install or execute anything.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
AI-PM Multi-Agent Skill System
v3.1 Ironforge — 业内自创 Skill+Harness 双轨架构 · 多Agent协作开发框架
知识包（Skill）与执行载体（Harness）彻底解耦 — 行为规范平台无关，运行配置按需适配
为什么这个架构不同？
现有的多Agent框架大多把"Agent该做什么"和"Agent在哪跑"混在一起——换平台就得重写，加Agent就得复制粘贴，出问题了只能靠Agent自觉。
AI-PM v3.1 Ironforge 首创 Skill + Harness 双轨架构，将行为规范与执行载体彻底解耦，并通过 Ironforge 企业工程化框架将软约束锻造成硬骨架：
| 传统多Agent框架 | AI-PM v3.1 Ironforge |
|---|---|
| 行为规范和平台配置耦合 | Skill（知识包）与 Harness（执行载体）彻底分离 |
| 换平台 = 重写全部 Agent | 行为规范层平台无关，只改 Harness 适配层 |
| 加 Agent = 复制粘贴大量重复配置 | base/ 公共层 + 特化层，改一处生效全局 |
| 安全靠 prompt 告诉 Agent 不要做 | 三层权限强制执行：物理阻断 > 逻辑拦截 > 行为自律 |
| 崩溃了靠 Agent 自己理解恢复 | 确定性检查点恢复 + 三级熔断 + 幂等性保障 |
| 心跳是给人看的 Markdown | HEARTBEAT v2：机器可解析 + 人可阅读双格式 |
| 每个 Agent 必须走全流程 | 能力驱动：每个 Skill 可独立运行，编排是可选组合 |
| 上下文要么全有要么全无 | 三级自适应：FULL / PARTIAL / MINIMAL 按需降级 |
三层架构
┌─────────────────────────────────────────────────────────────┐
│ Layer 0 · pm-core（内核层） │
│ │
│ 上下文协议 · 生命周期 · 通信 · 恢复 · 平台抽象 │
│ 🔒 安全：权限框架 + 敏感信息防护 + 审计日志 │
│ 🛡️ 稳定：检查点回滚 + 三级熔断 + 幂等性 │
│ 📊 可观测：HEARTBEAT v2 + 指标 + 追踪 │
│ │
│ 所有 Skill 自动继承，无需显式配置 │
├─────────────────────────────────────────────────────────────┤
│ Layer 1 · Skills（能力层） │
│ │
│ 10 个独立 Skill，每个可单独运行或被委托调用 │
│ 每个Skill有三模式工作流：MINIMAL / PARTIAL / FULL │
│ ★ 行为规范（SKILL.md）平台无关，不绑定任何AI平台 │
│ │
│ pm-orchestrator · pm-backlog-manager · pm-analyst │
│ pm-planner · pm-designer · pm-runner │
│ pm-coder · pm-researcher · pm-writer │
│ web-design-engineer（独立挂载，pm-coder 可委托） │
├─────────────────────────────────────────────────────────────┤
│ Layer 2 · Orchestrations（编排层） │
│ │
│ 预定义编排模板，按需组合 Skills │
│ code-only · research-only · analysis-only · doc-only │
│ full-pipeline · custom（用户自定义） │
└─────────────────────────────────────────────────────────────┘
Skill + Harness 双轨架构
核心创新：将 Agent 的"做什么"和"在哪跑"彻底分离，实现知识复用与平台适配的完全解耦。
┌──────────────────────────────────────────────────────────────┐
│ 双轨架构 │
│ │
│ Skill 轨道（知识包） Harness 轨道（执行载体） │
│ ┌───────────────────┐ ┌───────────────────┐ │
│ │ SKILL.md │ │ 运行环境配置 │ │
│ │ 行为规范 │ ← 绑定 ─ │ spawn配置 │ │
│ │ 工作流程 │ │ 工具绑定 │ │
│ │ 输出模板 │ │ 通信协议 │ │
│ │ 禁止事项 │ │ 权限级别 │ │
│ │ references/ │ │ Skill加载策略 │ │
│ └───────────────────┘ └───────────────────┘ │
│ ↓ 平台无关 ↓ 平台相关 │
│ 写一次，所有平台可用 换平台只改这里 │
└──────────────────────────────────────────────────────────────┘
| 维度 | Skill（知识包） | Harness（执行载体） |
|---|---|---|
| 本质 | SOP 手册 | 带工具箱的工作台 |
| 类比 | 烹饪菜谱 | 厨房设备配置 |
| 定义内容 | 角色定位、工作流程、输出模板、禁止事项 | spawn配置、工具绑定、通信协议、Skill加载策略 |
| 文件位置 | {skills_root}/pm-{name}/SKILL.md | harnesses/{agent}-harness.md |
| 平台绑定 | ❌ 无（v3 平台无关） | ✅ 有（适配特定AI平台） |
| 生命周期 | 项目级（不随任务变化） | 任务级（每次创建子Agent重新配置） |
Harness 分层架构（v3.1 Ironforge 核心改造）
harnesses/
├── base/ ← 公共层（7个文件，所有Agent共享）
│ ├── permission-framework.md # 权限强制执行
│ ├── security-hooks.md # 安全钩子
│ ├── audit-logging.md # 审计日志
│ ├── checkpoint-protocol.md # 检查点协议
│ ├── handoff-protocol.md # 交接棒协议
│ ├── context-engineering.md # 上下文工程
│ └── observability-config.md # 可观测性配置
│
├── coder-harness.md ← 特化层（只写Agent独有逻辑）
├── runner-harness.md ← 继承base + 特化逻辑
└── ... 其余7个同理
改造前后对比：
| 指标 | 改造前 | 改造后 |
|---|---|---|
| 单个 Harness 代码量 | ~1055行 | ~100行（特化层） |
| 总代码量 | ~3000行（大量重复） | ~2100行（零重复） |
| 安全策略更新 | 改9个文件 | 改 base/security-hooks.md 1处 |
| 新增 Agent | 复制+删减 | 新建特化层，自动继承 base/ |
v3.1 Ironforge 三大支柱
Ironforge（铁炉堡） — 把软约束锻造成硬骨架。从"告诉Agent不要做"升级为"让Agent做不到"。
🔒 Fortify · 安全加固
约束可执行：每条安全规则必须有物理阻断机制
| 层 | 机制 | 强度 |
|---|---|---|
| 平台物理层 | spawn mode + blocked_tools | 最高（不可绕过） |
| Harness逻辑层 | 黄灯操作通知 + 拦截窗口 | 中（有监督） |
| SKILL.md行为层 | 编码规范·禁止事项 | 低（兜底） |
| 敏感信息防护 | 写入前正则扫描 | — |
| 审计日志 | JSONL + trace_id | — |
🛡️ Stabilize · 稳定性加固
故障可恢复：每个步骤都有检查点，崩溃后确定性恢复
| 机制 | 关键设计 |
|---|---|
| 检查点协议 | 3类检查点 + hash校验 |
| 三级熔断 | Agent→任务→项目 |
| 幂等性规范 | 0匹配=跳过 + pre_check |
orchestrator 最严格（1次/15min熔断），只读Agent检查点少
📊 Observe · 可观测性加固
操作可追溯：每个操作都有结构化记录
| 机制 | 关键设计 |
|---|---|
| HEARTBEAT v2 | YAML + Markdown 双格式 |
| 指标收集 | C/G/H 三类指标 |
| 分布式追踪 | trace_id 贯穿全链路 |
| 自动监控 | 5条告警规则 |
高解耦设计
能力驱动，而非流程驱动
v3 核心变革：每个 Skill 可独立运行，编排是可选的组合层，不是强制的流程链。
| 使用方式 | 适用场景 | 示例 |
|---|---|---|
| 单Skill | 改Bug、调研、写文档 | "帮我改个Bug" → pm-coder |
| 预定义编排 | 需求分析、PRD | "梳理需求+拆解" → analysis-only |
| 全链路编排 | 完整项目开发 | "从0做个App" → full-pipeline |
| 自定义编排 | 灵活组合 | 自定义 YAML 编排模板 |
上下文自适应（三级降级）
| 等级 | 条件 | 行为 |
|---|---|---|
| FULL | 所有前置文档齐全 | 严格对齐，按流程验收 |
| PARTIAL | 部分文档存在 | 对齐已有，缺失从用户推导 |
| MINIMAL | 无前置文档 | 直接接收用户指令，轻量运行 |
平台抽象层
行为规范层（SKILL.md、pm-core/、orchestrations/）不绑定任何特定AI平台：
| 路径变量 | 说明 | 映射示例 |
|---|---|---|
{context_root} | 项目上下文根目录 | .workbuddy/、.cursor/、.cline/ |
{skills_root} | Skills 安装目录 | ~/.workbuddy/skills/、项目级 skills/ |
架构概览（全链路模式）
┌──────────────────────────────────────────────────────────────┐
│ orchestrator 职责分层 │
│ │
│ 【核心】上下文同步 · 结果收集 · 监听 │
│ 【全局】阶段切换 · 打回路由 · 用户交互 · 复盘 │
│ 【不做】需求/拆解/Skills/调度/编码/文档 │
└──────────────────────────────┬───────────────────────────────┘
│
┌───────────────────────────┼──────────────────────────┐
▼ ▼ ▼
┌────────────┐ ┌────────────┐ ┌────────────┐
│ Phase 0 │ │ Phase 1 │ │ Phase 2 │
│ 需求池管理 │────────→ │ 分析→拆解 │────────→ │ 原型设计 │
│ +MVP定义 │ │ │ │ （并行） │
│ backlog │
// HOW IT'S BUILT
KEY FILES