refactor(clarity-assist): extract skills from commands

Extract shared knowledge from clarify.md and quick-clarify.md into reusable skill files: - 4d-methodology.md: Core 4-phase clarification process - nd-accommodations.md: Neurodivergent-friendly question patterns - clarification-techniques.md: Anti-patterns and question templates - escalation-patterns.md: Mode switching guidelines Commands slimmed from 149/96 lines to 44/49 lines respectively. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 17:23:40 -05:00
parent 747a2b15e5
commit 5bf1271347
18 changed files with 1067 additions and 1141 deletions
--- a/plugins/pr-review/skills/output-formats.md
+++ b/plugins/pr-review/skills/output-formats.md
@@ -0,0 +1,200 @@
+# Output Formats
+
+## Visual Header
+
+All commands display this header:
+
+```
+----------------------------------------------------------------------+
+|  PR-REVIEW [Command Name]                                            |
+----------------------------------------------------------------------+
+```
+
+## Review Report Format
+
+```
+===================================================
+PR Review Report: #<number>
+===================================================
+
+Summary:
+  Files changed: <n>
+  Lines: +<added> / -<removed>
+  Agents consulted: <list>
+
+Findings: <total>
+  Critical: <n>
+  Major: <n>
+  Minor: <n>
+  Suggestions: <n>
+
+---------------------------------------------------
+CRITICAL FINDINGS
+---------------------------------------------------
+
+[<ID>] <Title> (Confidence: <score>)
+File: <path>:<line>
+Category: <category>
+
+<Description>
+
+Suggested fix:
+<code block>
+
+---------------------------------------------------
+VERDICT: <APPROVE|COMMENT|REQUEST_CHANGES>
+---------------------------------------------------
+
+<Justification>
+```
+
+## Summary Format
+
+```
+===================================================
+PR Summary: #<number> - <title>
+===================================================
+
+Author: @<username>
+Branch: <head> -> <base>
+Status: <status>
+
+---------------------------------------------------
+CHANGES OVERVIEW
+---------------------------------------------------
+
+Files: <n> changed
+  + <n> new files
+  ~ <n> modified files
+  - <n> deleted files
+
+Lines: +<added> / -<removed> (net +<diff>)
+
+---------------------------------------------------
+WHAT THIS PR DOES
+---------------------------------------------------
+
+<Plain-language description>
+
+---------------------------------------------------
+KEY FILES
+---------------------------------------------------
+
+* <path> (+<lines>) - <description>
+
+---------------------------------------------------
+QUICK ASSESSMENT
+---------------------------------------------------
+
+Scope: <Small|Medium|Large>
+Risk: <Low|Medium|High>
+Recommendation: <action>
+===================================================
+```
+
+## Findings List Format
+
+### Detailed (default)
+
+```
+===================================================
+PR #<number> Findings (filtered: <filter>)
+===================================================
+
+Showing <n> of <total> findings
+
+---------------------------------------------------
+
+[<ID>] <Title>
+Confidence: <score> (<label>) | Severity: <level>
+File: <path>:<line>
+
+<Description>
+
+Fix: <suggestion>
+
+---------------------------------------------------
+```
+
+### Compact (--compact)
+
+```
+<ID> | <Severity> | <Confidence> | <File>:<Line> | <Title>
+```
+
+### JSON (--json)
+
+```json
+{
+  "pr": <number>,
+  "findings": [
+    {
+      "id": "<ID>",
+      "category": "<category>",
+      "severity": "<severity>",
+      "confidence": <score>,
+      "file": "<path>",
+      "line": <number>,
+      "title": "<title>",
+      "description": "<description>",
+      "fix": "<suggestion>"
+    }
+  ]
+}
+```
+
+## Setup Complete Format
+
+```
+============================================================+
+|                  PR-REVIEW SETUP COMPLETE                  |
+============================================================+
+| MCP Server (Gitea):    Ready                               |
+| System Config:         ~/.config/claude/gitea.env          |
+| Project Config:        ./.env                              |
+============================================================+
+```
+
+## Project Configured Format
+
+```
+============================================================+
+|                   PROJECT CONFIGURED                       |
+============================================================+
+| Organization:  <org>                                       |
+| Repository:    <repo>                                      |
+| Config file:   ./.env                                      |
+============================================================+
+
+Ready to review PRs:
+- /pr-review <number>   Full multi-agent review
+- /pr-summary <number>  Quick summary
+- /pr-findings <number> List findings
+```
+
+## Annotated Diff Format
+
+```
+===================================================
+PR #<number> Diff - <title>
+===================================================
+
+Branch: <head> -> <base>
+Files: <n> changed (+<added> / -<removed>)
+
+---------------------------------------------------
+<file> (+<added> / -<removed>)
+---------------------------------------------------
+
+@@ -<old>,<ctx> +<new>,<ctx> @@ <context>
+  <line> |   existing code
+  <line> |-  removed code
+         |   +--- COMMENT by @<user> (<time>) ---
+         |   | <comment text>
+         |   +-----------------------------------
+  <line> |+  added code
+
+===================================================
+Comment Summary: <n> comments, <n> resolved
+===================================================
+```