opencode-onboard 0.1.2 → 0.1.4

package/content/.agents/skills/ob-pullrequest-gh/SKILL.md

@@ -0,0 +1,140 @@
+---
+name: ob-pullrequest-gh
+description: Create GitHub PRs with screenshots, or read and triage PR review feedback. Use when shipping a feature branch or when user says "I've added comments to the PR".
+license: MIT
+compatibility: Requires gh CLI, openspec CLI, and opencode-browser for screenshots.
+metadata:
+  author: copilots
+  version: "1.0"
+---
+
+**RTK - MANDATORY**
+
+Use `rtk` wrapper for ALL CLI commands:
+- `rtk git add` NOT `git add`
+- `rtk git commit` NOT `git commit`
+- `rtk git push` NOT `git push`
+- `rtk gh pr create` NOT `gh pr create`
+- `rtk gh pr comment` NOT `gh pr comment`
+- `rtk gh api` NOT `gh api`
+
+**Browser MCP tools are FORBIDDEN for all GitHub operations.**
+Browser tools are ONLY permitted for screenshots of the LOCAL running app on `localhost` URLs.
+
+---
+
+## Mode A: Create PR (ship mode)
+
+Triggered when devops-manager is in ship mode after implementation is complete.
+
+### Step 1: Verify feature branch
+
+```bash
+rtk git branch --show-current
+```
+
+Branch must be `feature/{id}-{slug}`. NEVER push to `main`.
+
+### Step 2: Capture screenshots (if UI changes exist)
+
+```bash
+browser_navigate url="http://localhost:{port}/{route}"
+browser_wait ms=2000
+browser_screenshot
+```
+
+Save to: `openspec/changes/{change-name}/images/{feature}.png`
+
+### Step 3: Commit and push
+
+```bash
+rtk git add .
+rtk git commit -m "feat(#{id}): {description}"
+rtk git push origin feature/{slug}
+```
+
+### Step 4: Create PR
+
+```bash
+rtk gh pr create \
+  --base main \
+  --head feature/{slug} \
+  --title "feat: {title}" \
+  --body "{description}"
+```
+
+### Step 5: Post screenshot comment
+
+Build raw URL for each image:
+```
+https://raw.githubusercontent.com/{owner}/{repo}/feature/{slug}/openspec/changes/{change}/images/{file}.png
+```
+
+Post comment:
+```bash
+rtk gh pr comment {pr-number} --body $'## Screenshots\n\n![{feature}]({raw-url})'
+```
+
+---
+
+## Mode B: Read PR Feedback (feedback mode)
+
+Triggered when user says "I've added comments to the PR" or "check PR feedback".
+
+### Step 1: Find PRs
+
+If PR link provided, extract number from URL. Otherwise:
+```bash
+rtk gh pr list --state open --limit 1
+```
+
+### Step 2: Read comment threads
+
+```bash
+rtk gh pr view {pr-number} --comments
+# Or structured output:
+rtk gh api repos/{owner}/{repo}/pulls/{pr-number}/comments
+rtk gh api repos/{owner}/{repo}/pulls/{pr-number}/reviews
+```
+
+### Step 3: Categorize feedback
+
+| Category | Description | Action |
+|----------|-------------|--------|
+| `code-change` | Reviewer requests code modification | Return to lead to spawn specialists |
+| `spec-update` | Affects proposal, design, or tasks | Update openspec artifacts |
+| `question` | Reviewer asks a question | Reply with answer |
+| `resolved` | Thread already resolved | Skip |
+
+### Step 4: Update openspec (if spec-update)
+
+```bash
+rtk git branch --show-current
+# feature/add-user-auth → change: add-user-auth
+```
+
+Update: `openspec/changes/{change}/proposal.md`, `design.md`, or `tasks.md` as appropriate.
+
+### Step 5: Reply to each comment thread
+
+```bash
+# Reply to a review comment
+rtk gh api repos/{owner}/{repo}/pulls/{pr-number}/comments/{comment-id}/replies \
+  --method POST \
+  --field body="Acknowledged — applying this change now."
+
+# Or post a general PR comment
+rtk gh pr comment {pr-number} --body "Updated design.md to reflect feedback."
+```
+
+---
+
+## Guardrails
+
+- ✅ Commit and push to feature branches only
+- ✅ Create and comment on PRs via gh CLI
+- ✅ Screenshots of localhost only via browser_screenshot
+- ❌ Commit or push to `main` — FORBIDDEN
+- ❌ Force push — FORBIDDEN
+- ❌ Merge or approve PRs — human-only
+- ❌ Navigate browser to github.com — FORBIDDEN

package/content/.agents/skills/ob-userstory-az/SKILL.md

@@ -1,206 +1,172 @@
----
-name: ob-userstory-az
-description: Parse Azure DevOps user story URL and create OpenSpec change. Use when user provides an Azure DevOps URL.
-license: MIT
-compatibility: Requires openspec CLI and Azure CLI.
-metadata:
-  author: copilots
-  version: "3.0"
----
-
-**RTK - MANDATORY**
-
-Use `rtk` wrapper for ALL CLI commands:
-- `rtk az boards work-item show` NOT `az boards work-item show`
-- `rtk openspec new change` NOT `openspec new change`
-
-**Browser MCP tools are FORBIDDEN for all Azure DevOps operations.**
-
----
-
-## Azure CLI Setup (One-Time)
-
-```bash
-az config set extension.dynamic_install_allow_preview=true
-az extension add --name azure-devops
-az login
-az devops login --organization https://dev.azure.com/plainconcepts
-```
-
-**PAT Token**, go to `https://dev.azure.com/plainconcepts/_usersSettings/tokens`
-Create with scopes: **Work Items (Read & Write)** + **Code (Read & Write)**
-
----
-
-## Steps
-
-1. **Extract Work Item ID** from URL
-   - `?workitem=193208` → ID: 193208
-   - `/workitems/edit/193208` → ID: 193208
-
-2. **Fetch Work Item**
-   ```bash
-   rtk az boards work-item show --id 193208
-   ```
-   Do NOT use `--organization` flag (uses default org).
-
-3. **Extract Key Fields** from JSON response:
-   - `fields.System.Title` → Title
-   - `fields.System.Description` → Description (may be HTML, strip tags)
-   - `fields.System.WorkItemType` → Type
-   - `fields.System.IterationPath` → Sprint
-   - `fields.System.State` → State
-   - `fields.System.AcceptanceCriteria` → AC (if present)
-
-4. **Create OpenSpec Change**
-   ```bash
-   rtk openspec new change "us-{id}-{slug}"
-   ```
-
----
-
-## Full Azure DevOps CLI Reference
-
-Use these for ALL DevOps operations, browser MCP is FORBIDDEN.
-
-### Work Items
-```bash
-# Read work item
-rtk az boards work-item show --id <id>
-
-# Update work item state
-rtk az boards work-item update --id <id> --state "Active"
-```
-
-### Pull Requests
-```bash
-# List open PRs
-rtk az repos pr list --repository <repo> --status active --top 5
-
-# Show PR details
-rtk az repos pr show --id <pr-id>
-
-# Create PR
-rtk az repos pr create \
-  --repository <repo> \
-  --source-branch feature/<id>-<slug> \
-  --target-branch main \
-  --title "feat(#<id>): <title>" \
-  --description "<description>"
-
-# Update PR description
-rtk az repos pr update --id <pr-id> --description "<text>"
-
-# Link work item to PR (run sequentially, not parallel)
-rtk az repos pr work-item add --id <pr-id> --work-items <work-item-id>
-```
-
-### PR Threads (Comments)
-```bash
-# Read all threads
-rtk az devops invoke \
-  --area git --resource pullRequestThreads \
-  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> \
-  --http-method GET --api-version 7.1
-
-# Post new comment thread (requires body.json)
-rtk az devops invoke \
-  --area git --resource pullRequestThreads \
-  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> \
-  --http-method POST --api-version 7.1 --in-file body.json
-
-# Reply to existing thread
-rtk az devops invoke \
-  --area git --resource pullRequestThreadComments \
-  --route-parameters project=PlainConcepts.CapacityTool repositoryId=<repo> pullRequestId=<id> threadId=<tid> \
-  --http-method POST --api-version 7.1 --in-file reply.json
-```
-
-### Comment Body JSON format
-```json
-{
-  "comments": [
-    {
-      "parentCommentId": 0,
-      "content": "Your markdown comment here.",
-      "commentType": 1
-    }
-  ],
-  "status": "active"
-}
-```
-
-For replies, `parentCommentId` should be the ID of the first comment in the thread (usually 1).
-
----
-
-## Screenshot / Image Strategy
-
-**Never upload images as PR attachments.** Save to openspec change folder and reference via raw URL.
-
-### Save location
-```
-openspec/changes/{change-name}/images/{screenshot}.png
-```
-
-### Raw URL format (renders inline in PR comments)
-```
-https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1
-```
-
-Do NOT use `_git/` URLs, they return HTML, not raw binary.
-
-### PR comment with screenshot
-```json
-{
-  "comments": [
-    {
-      "parentCommentId": 0,
-      "content": "## Screenshots\n\n![Description](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1)",
-      "commentType": 1
-    }
-  ],
-  "status": "active"
-}
-```
-
----
-
-## URL Formats Reference
-
-```
-# Sprint board with work item
-https://dev.azure.com/{org}/{project}/_sprints/backlog/{team}/{project}/Sprint%20110?workitem=193208
-
-# Direct work item
-https://dev.azure.com/{org}/{project}/_workitems/edit/193208
-
-# PR
-https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{pr-id}
-```
-
----
-
-## Output Format
-
-```
-## User Story Parsed
-
-**Work Item:** #193208
-**Title:** Roles CRUD
-**Type:** User Story
-**Iteration:** Sprint 110
-**State:** New
-
-**Change Created:** us-193208-roles-crud
-
-### Next Steps
-1. Review the proposal
-2. Say "implement the plan" to start implementation
-```
-
-## Constraints
-
-- This skill only PARSES and PROPOSES, implementation via openspec-apply-change
-- Always use `rtk` for CLI commands
-- Browser MCP tools FORBIDDEN for all DevOps operations
+---
+name: ob-userstory-az
+description: Parse Azure DevOps user story URL and create OpenSpec change. Use when user provides an Azure DevOps URL.
+license: MIT
+compatibility: Requires openspec CLI and Azure CLI.
+metadata:
+  author: copilots
+  version: "3.1"
+---
+
+**RTK - MANDATORY**
+
+Use `rtk` wrapper for ALL CLI commands:
+- `rtk az boards work-item show` NOT `az boards work-item show`
+- `rtk openspec new change` NOT `openspec new change`
+
+**Browser MCP tools are FORBIDDEN for all Azure DevOps operations.**
+
+---
+
+## Azure CLI Setup (One-Time)
+
+```bash
+az config set extension.dynamic_install_allow_preview=true
+az extension add --name azure-devops
+az login
+az devops login --organization https://dev.azure.com/{org}
+```
+
+**PAT Token**, go to `https://dev.azure.com/{org}/_usersSettings/tokens`
+Create with scopes: **Work Items (Read & Write)** + **Code (Read & Write)**
+
+---
+
+## Steps
+
+1. **Extract Work Item ID** from URL
+   - `?workitem=193208` → ID: 193208
+   - `/workitems/edit/193208` → ID: 193208
+
+2. **Fetch Work Item**
+   ```bash
+   rtk az boards work-item show --id 193208
+   ```
+   Do NOT use `--organization` flag (uses default org).
+
+3. **Extract Key Fields** from JSON response:
+   - `fields.System.Title` → Title
+   - `fields.System.Description` → Description (may be HTML, strip tags)
+   - `fields.System.WorkItemType` → Type
+   - `fields.System.IterationPath` → Sprint
+   - `fields.System.State` → State
+   - `fields.System.AcceptanceCriteria` → AC (if present)
+
+4. **Create OpenSpec Change**
+   ```bash
+   rtk openspec new change "us-{id}-{slug}"
+   ```
+
+---
+
+## Full Azure DevOps CLI Reference
+
+Use these for ALL DevOps operations, browser MCP is FORBIDDEN.
+
+### Work Items
+```bash
+# Read work item
+rtk az boards work-item show --id <id>
+
+# Update work item state
+rtk az boards work-item update --id <id> --state "Active"
+```
+
+### PR Threads (Comments)
+```bash
+# Read all threads
+rtk az devops invoke \
+  --area git --resource pullRequestThreads \
+  --route-parameters project={project} repositoryId=<repo> pullRequestId=<id> \
+  --http-method GET --api-version 7.1
+
+# Post new comment thread (requires body.json)
+rtk az devops invoke \
+  --area git --resource pullRequestThreads \
+  --route-parameters project={project} repositoryId=<repo> pullRequestId=<id> \
+  --http-method POST --api-version 7.1 --in-file body.json
+
+# Reply to existing thread
+rtk az devops invoke \
+  --area git --resource pullRequestThreadComments \
+  --route-parameters project={project} repositoryId=<repo> pullRequestId=<id> threadId=<tid> \
+  --http-method POST --api-version 7.1 --in-file reply.json
+```
+
+### Comment Body JSON format
+```json
+{
+  "comments": [
+    {
+      "parentCommentId": 0,
+      "content": "Your markdown comment here.",
+      "commentType": 1
+    }
+  ],
+  "status": "active"
+}
+```
+
+For replies, `parentCommentId` should be the ID of the first comment in the thread (usually 1).
+
+---
+
+## Screenshot / Image Strategy
+
+**Never upload images as PR attachments.** Save to openspec change folder and reference via raw URL.
+
+### Save location
+```
+openspec/changes/{change-name}/images/{screenshot}.png
+```
+
+### Raw URL format (renders inline in PR comments)
+```
+https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1
+```
+
+Do NOT use `_git/` URLs, they return HTML, not raw binary.
+
+---
+
+## URL Formats Reference
+
+```
+# Sprint board with work item
+https://dev.azure.com/{org}/{project}/_sprints/backlog/{team}/{project}/Sprint%20110?workitem=193208
+
+# Direct work item
+https://dev.azure.com/{org}/{project}/_workitems/edit/193208
+
+# PR
+https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{pr-id}
+```
+
+---
+
+## Output Format
+
+```
+## User Story Parsed
+
+**Work Item:** #{id}
+**Title:** {title}
+**Type:** User Story
+**Iteration:** {sprint}
+**State:** {state}
+
+**Change Created:** us-{id}-{slug}
+
+### Next Steps
+1. Review the proposal
+2. Say "implement the plan" to start implementation
+```
+
+---
+
+## Guardrails
+
+- ✅ Parse Azure DevOps URL and create OpenSpec change
+- ✅ Use `rtk` for all Azure CLI operations
+- ❌ Browser MCP tools for Azure DevOps operations — FORBIDDEN
+- ❌ Implementation — this skill only parses and proposes

package/content/.agents/skills/ob-userstory-gh/SKILL.md

@@ -5,9 +5,17 @@ license: MIT
 compatibility: Requires openspec CLI and gh CLI.
 metadata:
   author: copilots
-  version: "1.0"
+  version: "1.1"
 ---
 
+**RTK - MANDATORY**
+
+Use `rtk` wrapper for ALL CLI commands:
+- `rtk gh issue view` NOT `gh issue view`
+- `rtk gh issue list` NOT `gh issue list`
+- `rtk gh issue edit` NOT `gh issue edit`
+- `rtk openspec new change` NOT `openspec new change`
+
 **Browser MCP tools are FORBIDDEN for all GitHub operations.**
 
 ---
@@ -33,7 +41,7 @@ gh auth status
 
 2. **Fetch Issue**
    ```bash
-   gh issue view 42 --json number,title,body,labels,milestone,state
+   rtk gh issue view 42 --json number,title,body,labels,milestone,state
    ```
 
 3. **Extract Key Fields** from JSON response:
@@ -46,7 +54,7 @@ gh auth status
 
 4. **Create OpenSpec Change**
    ```bash
-   openspec new change "gh-{number}-{slug}"
+   rtk openspec new change "gh-{number}-{slug}"
    ```
 
 ---
@@ -58,55 +66,13 @@ Use these for ALL GitHub operations, browser MCP is FORBIDDEN.
 ### Issues
 ```bash
 # Read issue
-gh issue view <number>
+rtk gh issue view <number>
 
 # List open issues
-gh issue list --state open --limit 10
+rtk gh issue list --state open --limit 10
 
 # Update issue
-gh issue edit <number> --add-label "in-progress"
-```
-
-### Pull Requests
-```bash
-# List open PRs
-gh pr list --state open
-
-# Show PR details
-gh pr view <number>
-
-# Create PR
-gh pr create \
-  --base main \
-  --head feature/{slug} \
-  --title "feat: <title>" \
-  --body "<description>"
-
-# Update PR
-gh pr edit <number> --body "<text>"
-```
-
-### PR Comments
-```bash
-# Read PR comments
-gh pr view <number> --comments
-
-# Post PR comment
-gh pr comment <number> --body "Your markdown comment here."
-
-# Reply to review comment via API
-gh api repos/{owner}/{repo}/pulls/{pr-number}/comments/{comment-id}/replies \
-  --method POST \
-  --field body="Reply text here."
-```
-
-### Review Comments (structured)
-```bash
-# Get all review comments on a PR
-gh api repos/{owner}/{repo}/pulls/{pr-number}/comments
-
-# Get all reviews
-gh api repos/{owner}/{repo}/pulls/{pr-number}/reviews
+rtk gh issue edit <number> --add-label "in-progress"
 ```
 
 ---
@@ -125,11 +91,6 @@ openspec/changes/{change-name}/images/{screenshot}.png
 https://raw.githubusercontent.com/{owner}/{repo}/{branch}/openspec/changes/{change}/images/{file}.png
 ```
 
-### PR comment with screenshot
-```bash
-gh pr comment <number> --body "## Screenshots\n\n![Description](https://raw.githubusercontent.com/{owner}/{repo}/feature/{slug}/openspec/changes/{change}/images/{file}.png)"
-```
-
 ---
 
 ## URL Formats Reference
@@ -164,8 +125,11 @@ https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}
 2. Say "implement the plan" to start implementation
 ```
 
-## Constraints
+---
+
+## Guardrails
 
-- This skill only PARSES and PROPOSES, implementation via openspec-apply-change
-- Always use `gh` CLI for GitHub operations
-- Browser MCP tools FORBIDDEN for all GitHub operations
+- ✅ Parse GitHub Issue URL and create OpenSpec change
+- ✅ Use `rtk gh` for all GitHub CLI operations
+- ❌ Browser MCP tools for GitHub operations — FORBIDDEN
+- ❌ Implementation — this skill only parses and proposes