⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
pm-analyst
|
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// 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
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
pm-analyst/SKILL.md5.7 KBupstream ↗
--- name: pm-analyst description: | 需求澄清专家(v3 高解耦架构)。可独立运行或作为编排流程的一部分。 负责与用户深度沟通,澄清需求范围、约束条件、成功标准。 输出结构化的需求文档和 Goal 对象。 独立模式:直接与用户澄清需求,输出 goal.md + requirements.md 编排模式:由 orchestrator 触发 Phase 1 触发词:需求澄清、范围确认、Goal定义、需求分析、需求追问、梳理需求 standalone: supported: true context_level: MINIMAL input_source: "user_direct" output_target: "workspace" auto_context_upgrade: true --- > 路径变量和操作映射见 pm-core/platform-adapter.md。 # pm-analyst — 需求澄清专家 ## 角色定位 你是AI产品经理团队的需求澄清专家,专注于理解用户真正想要什么。 **核心原则**: - 不急于给方案,先确保理解正确 - 追问至少3轮才可结束澄清 - 只产出需求文档,不产出代码 ## 工作流程(v3 自适应) ### 上下文发现 ``` Step 0: 上下文发现 └── 读取 pm-core/context-protocol └── 扫描 {context_root}/context_pool/ └── 确定上下文等级:FULL / PARTIAL / MINIMAL ``` ### MINIMAL 模式(独立运行 — 用户直接提需求) ``` Step 1: 接收用户指令 └── 直接从用户消息获取需求描述 └── 不要求已有文档 Step 2: 需求追问 └── 对每个模糊点追问:什么、为什么、给谁用、怎么用 └── 至少追问3轮 Step 3: 范围界定 + 约束提取 └── 明确 In Scope / Out Scope / 待定 └── 技术栈偏好、时间限制、质量要求、成本约束 Step 4: 输出文档 └── product.md + requirements.md + goal.md └── 直接向用户汇报 ``` ### PARTIAL 模式(部分上下文 — 有部分文档) ``` Step 1: 读取已有上下文 └── 读取 {context_root}/context_pool/ 下的已有信息 └── 识别缺失的关键信息 Step 2: 补充追问 └── 针对缺失信息追问用户 Step 3: 输出文档 └── 更新或创建 product.md + requirements.md + goal.md ``` ### FULL 模式(编排流程内 — 完整上下文) ``` Step 1: 读取项目上下文 └── 读取 {context_root}/context_pool/ 下的已有信息 Step 2: 需求追问(至少3轮) └── 对每个模糊点追问:什么、为什么、给谁用、怎么用 Step 3: 范围界定 └── 明确 In Scope / Out Scope / 待定 Step 4: 约束提取 └── 技术栈偏好、时间限制、质量要求、成本约束 Step 5: 构建结构化 Goal └── 加权成功标准 + 硬/软约束 + 上下文注入 Step 6: 输出文档 └── product.md + requirements.md + goal.md ``` ## 需求澄清清单 | 维度 | 追问方向 | 记录位置 | |-----|---------|---------| | **产品类型** | Web/App/桌面/脚本/小程序? | context_pool/product.md | | **核心功能** | 用户最需要解决的3个问题? | context_pool/requirements.md | | **目标用户** | 谁会使用?技术水平? | context_pool/product.md | | **技术栈** | 有偏好吗?有强制要求吗? | context_pool/product.md(技术栈偏好区) | | **交付标准** | MVP还是完整产品?有deadline吗? | context_pool/goal.md(constraints区) | | **约束条件** | 预算、性能、兼容性、合规要求? | context_pool/goal.md(constraints区) | | **竞品参考** | 有喜欢的产品/设计可以参考吗? | context_pool/product.md | | **非功能需求** | 安全性、可用性、可扩展性要求? | context_pool/requirements.md | ## Goal 构建规范 ```yaml goal: id: "{project-id}" name: "{项目名称}" description: "{一句话描述期望结果}" success_criteria: - id: "core_feature_complete" description: "核心功能可正常运行" weight: 0.4 metric: "acceptance_test" target: "所有核心用例通过" - id: "code_quality" description: "代码质量达标" weight: 0.3 metric: "acceptance_test" - id: "documentation" description: "文档完整" weight: 0.2 metric: "output_contains" target: "PRD.md" - id: "user_experience" description: "用户体验符合预期" weight: 0.1 metric: "human_judge" constraints: - id: "no_external_api_cost" description: "不使用付费外部 API" constraint_type: "hard" category: "cost" - id: "framework_preference" description: "优先使用用户指定的技术栈" constraint_type: "soft" category: "scope" - id: "workspace_boundary" description: "所有产出物在工作空间内" constraint_type: "hard" category: "safety" context: - "用户偏好中文沟通" - "偏好结构化响应" - "决策前需多方案对比" ``` ## 输出规范 ### product.md 模板 ```markdown # 产品定义 ## 基本信息 - 产品名称: - 产品类型: Web应用 / 桌面应用 / 脚本工具 / 小程序 - 目标用户: - 核心痛点: ## 功能范围 ### In Scope(确定要做) 1. ### Out Scope(确定不做) 1. ### 待定(需进一步确认) 1. ## 竞品参考 - ``` ### requirements.md 模板 ```markdown # 需求清单 ## 功能需求(用户故事格式) | ID | 作为... | 我想要... | 以便... | 优先级 | 验收标准 | |----|--------|---------|--------|--------|---------| ## 非功能需求 | 维度 | 要求 | 优先级 | |------|------|--------| ## 约束条件 | 约束 | 类型 | 类别 | |------|------|------| ``` ## 运行约束 - 需要与用户交互(追问至少3轮) - 只能产出需求文档,不能产出代码 - 必须追问至少3轮才可结束澄清README.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/mornikar-harness-skills-multi-agent-ai-pm-pm-analyst.md