multi-agent-platform 0.2.0__tar.gz → 0.3.0__tar.gz

{multi_agent_platform-0.2.0/multi_agent_platform.egg-info → multi_agent_platform-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.2.0
+Version: 0.3.0
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -61,8 +61,26 @@ pip install multi-agent-platform
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
+## 让你的 AI Agent 自动使用 MAP
+
+两种方式，任选其一：
+
+**方式一：安装 Skill（推荐，完整功能）**
+
+```bash
+pip install multi-agent-platform
+map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
+```
+
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含两轮讨论门禁、实验生命周期等）。
+
+**方式二：使用简化 Prompt（快速上手）**
+
+复制 [MAP_AGENT_PROMPT.md](MAP_AGENT_PROMPT.md) 中的 prompt 内容，粘贴到你的 AI Agent 的 system prompt 或项目规则中。适合不想安装文件、快速体验的场景。
+
 ## 文档
 
+- [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
 - [Quick Start 指南（新用户必读）](docs/QUICKSTART.md)
 - [产品需求文档（PRD）](docs/prd/archive/v0.1.md)
 - [产品需求文档 v0.2（角色与项目边界）](docs/prd/archive/v0.2.md)

{multi_agent_platform-0.2.0 → multi_agent_platform-0.3.0}/README.md

@@ -16,8 +16,26 @@ pip install multi-agent-platform
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
+## 让你的 AI Agent 自动使用 MAP
+
+两种方式，任选其一：
+
+**方式一：安装 Skill（推荐，完整功能）**
+
+```bash
+pip install multi-agent-platform
+map skill install          # 将 6 个 Skill 文件安装到 .cursor/skills/
+```
+
+安装后 Cursor 会自动发现 Skill，AI Agent 读取后即可遵循完整的 MAP 协作流程（含两轮讨论门禁、实验生命周期等）。
+
+**方式二：使用简化 Prompt（快速上手）**
+
+复制 [MAP_AGENT_PROMPT.md](MAP_AGENT_PROMPT.md) 中的 prompt 内容，粘贴到你的 AI Agent 的 system prompt 或项目规则中。适合不想安装文件、快速体验的场景。
+
 ## 文档
 
+- [MAP Agent Prompt（给 AI Agent 的协作指南）](MAP_AGENT_PROMPT.md)
 - [Quick Start 指南（新用户必读）](docs/QUICKSTART.md)
 - [产品需求文档（PRD）](docs/prd/archive/v0.1.md)
 - [产品需求文档 v0.2（角色与项目边界）](docs/prd/archive/v0.2.md)

multi_agent_platform-0.3.0/cli/commands/skill.py

@@ -0,0 +1,168 @@
+"""``map skill ...`` sub-app — install bundled Skills to user's project.
+
+Commands:
+    map skill install   — Copy MAP Skill files from the pip package
+                          into the user's project (.cursor/skills/ by default)
+    map skill list      — List bundled Skills available for installation
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+
+skill_app = typer.Typer(help="Manage MAP Skills (install bundled Skills to your project)")
+
+# Directory name inside the cli package
+_SKILLS_PACKAGE_DIR = "skills"
+
+# Default install target relative to project root
+_DEFAULT_TARGET = ".cursor/skills"
+
+
+def _get_bundled_skills_dir() -> Path:
+    """Return the path to the bundled skills directory inside the cli package."""
+    try:
+        # Python 3.9+: importlib.resources.files
+        from importlib.resources import files as resource_files
+
+        skills_root = resource_files("cli").joinpath(_SKILLS_PACKAGE_DIR)
+        # resource_files may return a Traversable; resolve to a real Path
+        # for filesystem operations. When installed from a wheel, the
+        # package is unpacked to a real directory, so this always works.
+        return Path(str(skills_root))
+    except Exception:
+        # Fallback: resolve relative to this file
+        return Path(__file__).resolve().parent.parent / _SKILLS_PACKAGE_DIR
+
+
+def _list_skill_dirs() -> list[str]:
+    """Return subdirectory names (each is one Skill)."""
+    skills_root = _get_bundled_skills_dir()
+    if not skills_root.is_dir():
+        return []
+    return sorted(
+        d.name
+        for d in skills_root.iterdir()
+        if d.is_dir() and not d.name.startswith("_") and not d.name.startswith(".")
+    )
+
+
+@skill_app.command("list")
+def skill_list() -> None:
+    """List bundled Skills available for installation."""
+    skill_names = _list_skill_dirs()
+    if not skill_names:
+        typer.echo("No bundled Skills found. This may indicate a broken installation.")
+        raise typer.Exit(1)
+
+    typer.echo(f"{'Skill Name':<30} {'Has SKILL.md'}")
+    typer.echo("-" * 50)
+    skills_root = _get_bundled_skills_dir()
+    for name in skill_names:
+        has_md = (skills_root / name / "SKILL.md").exists()
+        typer.echo(f"{name:<30} {'yes' if has_md else 'no'}")
+
+
+@skill_app.command("install")
+def skill_install(
+    target: Path = typer.Option(
+        Path(_DEFAULT_TARGET),
+        "--target",
+        "-t",
+        help=f"Destination directory (default: {_DEFAULT_TARGET})",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing files without prompting",
+    ),
+    skill: list[str] | None = typer.Option(
+        None,
+        "--skill",
+        "-s",
+        help="Install only the named Skill (can be repeated). Default: all.",
+    ),
+) -> None:
+    """Install MAP Skill files into your project.
+
+    By default, copies all bundled Skill directories from the pip package
+    into ``.cursor/skills/`` in the current project. After installation,
+    your AI Agent (Cursor, Claude Code, etc.) can read the SKILL.md files
+    and follow the MAP collaboration workflow.
+
+    \b
+    Examples:
+        map skill install                     # Install all Skills
+        map skill install -t .map/skills      # Install to .map/skills/
+        map skill install -s topic-host        # Install only topic-host
+        map skill install --force              # Overwrite without asking
+    """
+    import shutil
+
+    skills_root = _get_bundled_skills_dir()
+    if not skills_root.is_dir():
+        typer.echo(
+            "Error: bundled Skills directory not found. "
+            "This may indicate a broken pip installation.",
+            err=True,
+        )
+        raise typer.Exit(1)
+
+    # Determine which Skills to install
+    available = _list_skill_dirs()
+    if not available:
+        typer.echo("Error: no Skills found to install.", err=True)
+        raise typer.Exit(1)
+
+    if skill:
+        # Validate requested skill names
+        missing = [s for s in skill if s not in available]
+        if missing:
+            typer.echo(
+                f"Error: unknown Skill(s): {', '.join(missing)}. "
+                f"Available: {', '.join(available)}",
+                err=True,
+            )
+            raise typer.Exit(1)
+        to_install = skill
+    else:
+        to_install = available
+
+    # Create target directory
+    target.mkdir(parents=True, exist_ok=True)
+
+    installed_count = 0
+    skipped_count = 0
+
+    for skill_name in to_install:
+        src = skills_root / skill_name
+        dst = target / skill_name
+
+        # Check for existing files
+        if dst.exists() and not force:
+            typer.echo(f"  Skip: {skill_name}/ (already exists; use --force to overwrite)")
+            skipped_count += 1
+            continue
+
+        # Remove existing directory if --force
+        if dst.exists() and force:
+            shutil.rmtree(dst)
+
+        # Copy the entire Skill directory
+        shutil.copytree(src, dst)
+        installed_count += 1
+
+        # Count files copied
+        file_count = sum(1 for _ in dst.rglob("*") if _.is_file())
+        typer.echo(f"  Installed: {skill_name}/ ({file_count} file(s))")
+
+    typer.echo(
+        f"\nDone: {installed_count} Skill(s) installed to {target}/"
+        + (f", {skipped_count} skipped" if skipped_count else "")
+    )
+    typer.echo(
+        "\nNext steps: point your AI Agent to the installed SKILL.md files. "
+        "For Cursor, they are automatically discovered from .cursor/skills/."
+    )

{multi_agent_platform-0.2.0 → multi_agent_platform-0.3.0}/cli/main.py

@@ -39,6 +39,7 @@ from cli.commands.notification import inbound_event_app, notification_app
 from cli.commands.persona import persona_app
 from cli.commands.project import project_app
 from cli.commands.runtime import runtime_app
+from cli.commands.skill import skill_app
 from cli.commands.sync import sync_app
 from cli.commands.topic import mention_app, todo_app, topic_app
 from cli.e2e_collab import e2e_app
@@ -65,6 +66,7 @@ app.add_typer(feedback_app, name="feedback")
 app.add_typer(docs_app, name="docs")
 app.add_typer(e2e_app, name="e2e")
 app.add_typer(sync_app, name="sync")
+app.add_typer(skill_app, name="skill")
 
 _transport: httpx.BaseTransport | None = None
 _cli_options: dict[str, Any] = {"persona": None, "project_root": None, "format": "yaml"}

multi_agent_platform-0.3.0/cli/skills/experiment-host/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: experiment-host
+description: >-
+  Execute MAP experiments as host when resumed by map-runtime-waker: acquire/release
+  execution lock, revise plans, implement repo changes, write execution logs via
+  map CLI. Do not rely on deprecated host bridge / cli.host_worker.
+---
+
+# MAP 实验执行（Host Skill）
+
+本仓库通过 **map-runtime-waker** 唤醒 host Agent session。你在实验 **review / running** 阶段**亲自**用 `map --persona host` CLI 与仓库工具完成工作。
+
+**已停用（勿依赖）**：`cli/host_worker`（host bridge）、`start-host-bridge*.sh` / `start-host-bridge-claude.sh`、runner 的 stdin/stdout JSON 契约。没有 bridge 会代写 MAP、代跑 `execute_experiment` 或代提交 git。
+
+协作入口见 [map-runtime-waker](../map-runtime-waker/SKILL.md)。
+
+## 硬性规则
+
+1. 先 `map --persona host persona whoami` 与 `map --persona host todos`
+2. 只用 `map --persona host ...` 写 MAP；禁止 MCP 写操作与手写 HTTP
+3. **`phase=running` 表示由你执行**——不要写「等 host bridge / auto-experiment-lifecycle 接手」
+4. 一次 wake 完成**当前 phase 的下一步**；`running` 阶段每次 wake 至少推进 **一个 plan 子项**（如 I1），写 execution log 后结束
+5. 实验须由本 host persona 创建，否则 approve/start/complete 会 403
+6. `complete` 只表示**提交结果待审批**（`running -> result_review`），不是最终完成；host 禁止自审结果
+7. `running` 阶段产生仓库改动时，默认必须提交一个窄 git commit；若无法安全区分当前实验改动与其他 dirty worktree，先停下并在 `experiment log` 记录 blocker，不要继续处理下一个实验
+
+## 快速入口
+
+```bash
+map --persona host persona whoami
+map --persona host work --notification-category wakeable
+map --persona host experiment status --id <exp-uuid>
+git status --short
+```
+
+判断顺序：
+
+1. `phase=running`：先 acquire lock，再改仓库、跑测试、写 log。
+2. `phase=result_review` 且 `actions=[]` / `blocked_on=awaiting_result_approval`：等待 reviewer，不继续执行、不 accept/reject。
+3. 收尾必须提交当前实验改动（若有）、release lock（若已 acquire），再刷新 `experiment status` 和 `work`。
+
+## Git
+
+你是直接改仓库的 Agent。**默认必须把每个实验/子项的已验证改动提交成窄 commit**，避免多个实验的 diff 混在一起；只有用户明确要求“不提交 git”时，才只改文件并在 `experiment log` 中说明。
+
+- 开始前：执行 `git status --short` 和 `git diff --stat`，识别已有 dirty worktree。
+- 若已有无关改动：不要自动混入提交；只 stage 当前实验明确相关文件。无法区分时停止执行，写 log 说明 blocker。
+- 完成一个可验证子项后：先运行验证，再提交 commit，message 使用 `map exp <short-id>: <summary>`。
+- 写 `experiment log` 时记录 `commit_sha`、`git_status_after`、改动文件和验证结果。
+- `experiment complete` 前：当前实验产生的改动必须已提交；否则不要 complete。
+- 回滚：用 commit sha 或 `git log --grep='map exp <short-id>'` 定位。
+
+建议命令：
+
+```bash
+git status --short
+git diff --stat
+# 验证通过后，只 stage 当前实验相关文件
+git add <files>
+git diff --cached --stat
+git commit -m "map exp <short-id>: <summary>"
+git rev-parse --short HEAD
+git status --short
+```
+
+## 执行锁（多 waker / 多 session 并发）
+
+同一项目同一时刻只允许 **一个** `running` 实验持有执行锁。`running` 阶段开始前应 acquire，结束后 release：
+
+```bash
+map --persona host experiment lock acquire --id <exp-uuid>   # 默认 TTL 1800s
+# ... 改代码、跑测试、写 log ...
+map --persona host experiment lock release --id <exp-uuid>
+```
+
+| 情况 | 处理 |
+|------|------|
+| acquire 失败（lock busy） | 另一实验正在执行；用 `experiment status` 看 holder，或 `lock skip --next-attempt-at <ISO8601>` 退避 |
+| 进程崩溃未 release | 服务端 TTL 到期后自动释放 |
+| 运维强制释放 | `experiment lock force-release --id <uuid> --reason "..."` |
+
+环境变量：`MAP_HOST_NO_LOCK=1` 跳过锁（仅调试）；`MAP_HOST_LOCK_DRY_RUN=1` 只打日志不阻塞。
+
+## my_open_experiments 各阶段
+
+| phase | 你应执行的动作 |
+|-------|----------------|
+| `draft` | `map experiment submit-review --id <id>` |
+| `review` 且 `open_unreasonable_count > 0` | 修订 plan（见下节 revise_plan） |
+| `review` 且 `open_unreasonable_count = 0` | `map experiment approve --id <id>` |
+| `approved` | `map experiment start --id <id>` |
+| `running` | 按 plan 改代码、跑测试、写 log（见 execute_experiment）；plan 全部验收通过后 `map experiment complete` 提交结果待审批 |
+| `result_review` | 等 reviewer `accept-result` 或 `reject-result`；若被驳回回到 `running`，继续返工 |
+
+> **观察项（v0.9 M30A+M31）**：`running` 期间如改动涉及 `inbound_events.rejection_count`（v1 fingerprint 拒绝路径），需在实验日志里附监控口径 —— 单 fingerprint `rejection_count` 增长率、累计 top-N fingerprint、是否需要 `map admin notification cleanup-v1` 兜底（待后续实验定义）。
+
+收到 `my_open_experiments` 待办 wake 时：
+
+```bash
+map --persona host experiment status --id <id>
+```
+
+若 waker prompt 或 `map work` 中的 `my_open_experiments` 样例带有 `actions`，这就是 host 的实验推进义务：先 `experiment status` 核实，再根据 **phase**、`actions` 与 **open_unreasonable_count** 执行上表对应动作。`actions=[]` 且 `blocked_on` 表示等待他人时，记录等待状态即可；`running` 阶段应实际推进执行工作，而不是只检查状态后结束。
+
+## revise_plan
+
+1. `map --persona host experiment review list --id <id>` 查看 open unreasonable 项
+2. 在原 plan 基础上修订完整 Markdown（非 diff），保存到例如 `.map/generated-plans/experiment-<id>-revised.md`
+3. 提交：
+
+```bash
+map --persona host experiment plan revise \
+  --id <exp-uuid> \
+  --plan-file ./path/to/revised.md \
+  --note "回应评审" \
+  --addressed-item <item-uuid>    # 每个 open unreasonable 项重复此选项
+```
+
+## execute_experiment（running 阶段）
+
+0. **（推荐）** `map --persona host experiment lock acquire --id <id>` — 若 lock busy 则 skip 并记录退避时间
+1. `map experiment status --id <id>` 阅读 `current_plan`
+2. `git status --short` / `git diff --stat` 检查工作树边界；若已有无关 dirty 改动且无法安全拆分，写 blocker 后停止
+3. 在仓库内**实际修改**文件；小步、可验证；不要无关重构
+4. 运行 plan 中列出的验证命令（pytest、grep 等）
+5. 将当前实验改动提交为窄 commit（用户明确禁止提交 git 时除外）
+6. 将执行记录写入临时文件，例如 `.map/generated-plans/experiment-<id>-log.md`，内容含：做了什么、改了哪些文件、验证结果、commit_sha、`git_status_after`、风险与后续
+7. 写入 MAP：
+
+```bash
+map --persona host experiment log \
+  --id <exp-uuid> \
+  --summary "I1 完成：…" \
+  --file ./path/to/log.md
+```
+
+8. 若 plan 定义的**全部 acceptance** 已满足，先准备 evidence metadata（例如 `.map/generated-plans/experiment-<id>-evidence.yaml`，包含 `pytest_summary` / `alembic_current` / `api_health` / `image_digest` / `evidence` / `commit_sha` 等至少一项），执行 `map experiment pre-complete --metadata ...`，再调用 `map experiment complete --metadata ...` 提交最终结果日志，实验进入 `result_review`；否则结束本次 wake，等待下次 `experiment_lifecycle` wake 继续下一子项
+9. **`experiment lock release --id <id>`**（若步骤 0 已 acquire）
+
+```bash
+map --persona host experiment pre-complete \
+  --id <exp-uuid> \
+  --metadata ./path/to/evidence.yaml
+
+map --persona host experiment complete \
+  --id <exp-uuid> \
+  --summary "结果提交：…" \
+  --file ./path/to/log.md \
+  --metadata ./path/to/evidence.yaml
+```
+
+### running 收尾模板
+
+```bash
+git status --short
+git diff --stat
+git add <files>
+git diff --cached --stat
+git commit -m "map exp <short-id>: <summary>"
+git rev-parse --short HEAD
+git status --short
+
+map --persona host experiment pre-complete \
+  --id <exp-uuid> \
+  --metadata .map/generated-plans/experiment-<short-id>-evidence.yaml
+
+map --persona host experiment complete \
+  --id <exp-uuid> \
+  --summary "结果提交：..." \
+  --file .map/generated-plans/experiment-<short-id>-result.md \
+  --metadata .map/generated-plans/experiment-<short-id>-evidence.yaml
+
+map --persona host experiment lock release --id <exp-uuid>
+map --persona host experiment status --id <exp-uuid>
+map --persona host work --notification-category wakeable
+```
+
+失败时按阶段停下：
+
+- `pre-complete` 失败：修 metadata 或验证证据，不要 complete。
+- `complete` 失败：实验仍在 `running`，保留锁或释放前写明 blocker。
+- `release` 失败：先查 `experiment status` 的 lock 字段，必要时记录 blocker。
+- `status` 显示 `result_review`：host 工作结束，等待 reviewer 审批。
+- `git status --short` 显示无关改动：不要混合提交；能明确拆分则只提交当前实验文件，不能拆分则写 blocker 并停止。
+- `git commit` 失败：不要 complete；先修复验证、lint 或提交边界问题。
+
+## 常见错误处理
+
+| 现象 | 处理 |
+|------|------|
+| metadata 文件不存在 / YAML 读失败 | 先创建或修正 evidence 文件，再重跑 `pre-complete`；不要把 traceback 当作 MAP 已写入 |
+| `complete` 缺 evidence | metadata 至少包含 `pytest_summary`、`alembic_current`、`api_health`、`image_digest` 或 `evidence`；非部署型才显式 `--allow-missing-evidence` |
+| lock busy | 用 `experiment status` 看 holder；必要时 `lock skip --next-attempt-at <ISO8601>` 退避 |
+| `403` lifecycle | 核对实验是否由当前 host persona 创建；不要换 MCP/admin 代跑 |
+| `result_review` 仍出现在清单 | 这是等待 reviewer 的可见性，不是 host 可执行项 |
+
+结果审批命令由 reviewer 或 admin 执行：
+
+```bash
+map --persona reviewer experiment accept-result \
+  --id <exp-uuid> \
+  --summary "结果通过：..." \
+  --file ./path/to/review.md
+
+map --persona reviewer experiment reject-result \
+  --id <exp-uuid> \
+  --summary "结果驳回：..." \
+  --file ./path/to/review.md
+```
+
+## 非目标
+
+- 启动或假设 host bridge 在后台运行
+- 返回 bridge 用的 JSON（`execution_log_md` 等）而不写 MAP log
+- 在 `running` 阶段只 approve/start 不实施
+- host 自己调用 `accept-result` 审批自己提交的实验结果
+
+## 参考
+
+- [map-runtime-waker](../map-runtime-waker/SKILL.md)
+- [topic-host](../topic-host/SKILL.md)
+- [map-project-collab](../map-project-collab/SKILL.md)
+- [MAP-RUNTIME-WAKER](../../docs/MAP-RUNTIME-WAKER.md)

multi_agent_platform-0.3.0/cli/skills/experiment-reviewer/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: experiment-reviewer
+description: >-
+  Review MAP experiment plans and accept/reject experiment results as reviewer
+  persona; follow action_items assigned via topic resolve. Use when map-runtime-waker
+  wakes reviewer for pending_review, pending_result_review, or addressed_review_item.
+---
+
+# MAP 实验评审（Skill）
+
+评审 Agent 对 **phase=review** 的实验计划给出结构化评审，并对 **phase=result_review** 的实验结果做通过/驳回审批。
+
+本仓库通过 **map-runtime-waker** 唤醒；你用 `map --persona reviewer` CLI **直接**写评审与 resolve，不经过 bridge/runner。
+
+**已停用**：reviewer bridge、`cli/*_worker` runner 代写路径。
+
+## 何时评审
+
+- `todos.pending_reviews` 中出现待评审实验
+- waker 发出 `pending_review` wake
+- 实验已 `submit-review`，当前计划版本尚未有本 reviewer 的评审记录
+- `todos.pending_result_reviews` 中出现结果待审批实验
+- waker 发出 `pending_result_review` wake
+- `todos.action_items` 中有分配给本 reviewer 的 open 项（在来源话题跟评或完成工作）
+- `todos.pending_round_acks` 非空 → 优先 `topic advance-round --ack accept`
+
+## 硬性规则
+
+1. 先 `map --persona reviewer persona whoami` 与 `todos`
+2. 只用 `map --persona reviewer ...` 写 MAP
+3. **不** approve / start / complete 实验（host 职责）
+4. **不**修改实验计划正文（修订是 host 的 `plan revise`）
+5. host 将项标为 `addressed` 后，你在 `addressed_review_item` wake 时检查并 `review resolve-item`
+6. 每条 reasonable / unreasonable 应具体、可验证，避免空泛褒贬
+7. 结果审批必须读取 `experiment status`、最终 log 和计划 acceptance；通过用 `accept-result`，不通过用 `reject-result` 并写清返工要求
+8. **行动项**：`map action list --mine` 查看分配项；完成后在来源话题 comment 说明，请 host 通过 `topic resolve` 更新 action_items
+9. 若同一实验同时有 `pending_replies` / addressed items 与 `pending_reviews`，先处理 addressed items；随后若 `pending_reviews` 仍显示当前计划版本且 `actions` 含 `review_add`，继续提交当前版本评审后再收尾。
+
+## 提交评审
+
+准备 `review.yaml`：
+
+```yaml
+reasonable_items:
+  - "目标清晰"
+unreasonable_items:
+  - "缺少验收标准"
+```
+
+```bash
+map --persona reviewer experiment review add \
+  --id <exp-uuid> \
+  --review ./review.yaml
+```
+
+`unreasonable_items` 为空表示无阻塞项；非空时 host 应 `plan revise` 并 `--addressed-item` 回应。
+
+在 host 修订计划并解决 addressed items 后，`pending_reviews` 表示当前 `current_plan_version` 仍缺本 reviewer 的评审记录。若修订已满足要求，提交一个无阻塞项的 review（reasonable_items 写明认可点，unreasonable_items 为空）；若仍有新问题，提交新的 unreasonable_items。不要只 resolve addressed items 后把仍存在的 `pending_reviews` 当成 stale。
+
+## 处理 addressed 项
+
+```bash
+map --persona reviewer experiment review list --id <exp-uuid>
+map --persona reviewer experiment review resolve-item \
+  --id <exp-uuid> \
+  --item-id <item-uuid>
+```
+
+## 审批实验结果
+
+```bash
+map --persona reviewer experiment status --id <exp-uuid>
+map --persona reviewer experiment logs --id <exp-uuid>
+
+map --persona reviewer experiment accept-result \
+  --id <exp-uuid> \
+  --summary "结果通过：验收标准已满足" \
+  --file ./result-review.md
+
+map --persona reviewer experiment reject-result \
+  --id <exp-uuid> \
+  --summary "结果驳回：缺少关键证据" \
+  --file ./result-review.md
+```
+
+`accept-result` 使实验进入 `done`；`reject-result` 使实验回到 `running`，host 继续返工。不要替 host 修改仓库或直接补执行日志。
+
+## 评审维度（建议）
+
+- 目标与范围是否清晰、可执行
+- 验收标准是否可观测（测试、日志、指标）
+- 与来源话题共识是否一致
+- 风险、依赖、Out of Scope 是否说明
+- 是否有遗漏的非目标或安全/权限问题
+- 实验结果是否覆盖计划中的 acceptance、测试命令、关键风险和产物路径
+
+## 非目标
+
+- 代替 host 执行实验或改仓库
+- 在评审中重写完整 plan（只列条目）
+- 假设 bridge 会自动 resolve
+- 对自己创建的实验做结果审批
+
+## 参考
+
+- [map-runtime-waker](../map-runtime-waker/SKILL.md)
+- [map-project-collab](../map-project-collab/SKILL.md)
+- [experiment-host](../experiment-host/SKILL.md)