diff --git a/packages/paperclip-runner/docs/capability-contract.md b/packages/paperclip-runner/docs/capability-contract.md index 13f829138c6..f7f83a587ef 100644 --- a/packages/paperclip-runner/docs/capability-contract.md +++ b/packages/paperclip-runner/docs/capability-contract.md @@ -167,7 +167,7 @@ The skill/reference inventory and eval cases are the only normative behavior sou | skill:skills/paperclip/references/api-reference.md:update:639 | optional_agent_tool | skills/paperclip/references/api-reference.md:639 | | skill:skills/paperclip/references/api-reference.md:cross-team-work-and-delegation:677 | optional_agent_tool | skills/paperclip/references/api-reference.md:677 | | skill:skills/paperclip/references/api-reference.md:receiving-cross-team-work:681 | optional_agent_tool | skills/paperclip/references/api-reference.md:681 | -| skill:skills/paperclip/references/api-reference.md:handling-blockers:691 | control_plane_owned | skills/paperclip/references/api-reference.md:691 | +| skill:skills/paperclip/references/api-reference.md:blocker-questions-and-dependencies:691 | control_plane_owned | skills/paperclip/references/api-reference.md:691 | | skill:skills/paperclip/references/api-reference.md:company-context:703 | optional_agent_tool | skills/paperclip/references/api-reference.md:703 | | skill:skills/paperclip/references/api-reference.md:company-branding-ceo-board:715 | optional_agent_tool | skills/paperclip/references/api-reference.md:715 | | skill:skills/paperclip/references/api-reference.md:openclaw-invite-prompt-ceo:735 | optional_agent_tool | skills/paperclip/references/api-reference.md:735 | diff --git a/packages/paperclip-runner/generated/capability/capabilities.yaml b/packages/paperclip-runner/generated/capability/capabilities.yaml index 2268d03db45..8ea9fdab386 100644 --- a/packages/paperclip-runner/generated/capability/capabilities.yaml +++ b/packages/paperclip-runner/generated/capability/capabilities.yaml @@ -634,10 +634,10 @@ { "id": "skill:skills/paperclip/references/api-reference.md:691", "kind": "skill_heading", - "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:handling-blockers", - "heading": "Handling blockers", - "primaryDisposition": "optional_agent_tool", - "semanticOperation": "scoped_discovery", + "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:blocker-questions-and-dependencies", + "heading": "Blocker questions and dependencies", + "primaryDisposition": "always_agent_tool", + "semanticOperation": "request_human_input", "expectedMockState": "operation_result" }, { diff --git a/packages/paperclip-runner/generated/capability/capability-contract.md b/packages/paperclip-runner/generated/capability/capability-contract.md index 68c9ba792e4..81f48f7e4c1 100644 --- a/packages/paperclip-runner/generated/capability/capability-contract.md +++ b/packages/paperclip-runner/generated/capability/capability-contract.md @@ -5,6 +5,6 @@ Generated by `scripts/generate-capability-contract.mjs`; do not edit generated f - Skill/reference headings: 156 - Legacy MCP tools: 42 - Eval cases: 106 across 16 groups -- Deterministic content SHA-256: `3f87a97ebaca6713f8586b11781cee582c6ae9af8dff452f2746302e6f079197` +- Deterministic content SHA-256: `243a7a37fc1130fb2bb5fd3a8e2eacedd0bb96cf63aff37c2527bba69829aed6` Every row has exactly one primary disposition, a source anchor, a semantic operation, and a mock-state expectation. diff --git a/packages/paperclip-runner/spec/capability/capabilities.yaml b/packages/paperclip-runner/spec/capability/capabilities.yaml index 3168283e606..a3ab6d5730f 100644 --- a/packages/paperclip-runner/spec/capability/capabilities.yaml +++ b/packages/paperclip-runner/spec/capability/capabilities.yaml @@ -1904,11 +1904,11 @@ ] }, { - "id": "skill:skills/paperclip/references/api-reference.md:handling-blockers:691", + "id": "skill:skills/paperclip/references/api-reference.md:blocker-questions-and-dependencies:691", "sourceKind": "skill_heading", "sourceAnchor": "skills/paperclip/references/api-reference.md:691", - "title": "Handling blockers", - "expectedSemantics": "Skill guidance headed “Handling blockers”.", + "title": "Blocker questions and dependencies", + "expectedSemantics": "Skill guidance headed “Blocker questions and dependencies”.", "primaryDisposition": "control_plane_owned", "requiredGrants": [], "assertionClasses": [ diff --git a/skills/paperclip/references/api-reference.md b/skills/paperclip/references/api-reference.md index 07d7a7253d7..4c9dd6bd406 100644 --- a/skills/paperclip/references/api-reference.md +++ b/skills/paperclip/references/api-reference.md @@ -683,12 +683,12 @@ You have **full visibility** across the entire org. The org structure defines re When you receive a task from outside your reporting line: 1. **You can do it** — complete it directly. -2. **You can't do it** — record the missing capability or authority and follow [Handling blockers](#handling-blockers) below. +2. **You can't do it** — record the missing capability or authority and follow [Blocker questions and dependencies](#blocker-questions-and-dependencies) below. 3. **You question whether it should be done** — you **cannot cancel it yourself**. Record the concern and request a decision through a saved interaction on the current task. If the requester is an agent, set `addresseeAgentId` to that agent and omit `resolverPolicy`; do not use the `human_only` example for an agent-directed question. If the requester is a user, set `addresseeUserId` to that user and `resolverPolicy: "human_only"`. Use `continuationPolicy: "wake_assignee"` and leave the task `in_review` while awaiting the answer. Keep the task assigned to yourself; this is a scope question, not a blocker handoff. **Do NOT** cancel a task assigned to you by someone outside your team. -### Handling blockers +### Blocker questions and dependencies If you are stuck or blocked: