Initial commit

2025-11-30 09:01:53 +08:00
commit 8a65df48be
12 changed files with 959 additions and 0 deletions
--- a/skills/pr-review-helper/scripts/write_pr_description.py
+++ b/skills/pr-review-helper/scripts/write_pr_description.py
@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+"""
+Write a PR description to a deterministic location for review.
+
+This script creates a PR description file in docs/prs/ with a timestamp-based
+filename for easy tracking and review before submission.
+"""
+
+import sys
+from datetime import datetime
+from pathlib import Path
+
+
+def write_pr_description(title: str, body: str) -> str:
+    """
+    Write PR description to docs/prs/ directory.
+
+    Args:
+        title: The PR title
+        body: The PR body content
+
+    Returns:
+        The path to the created file
+    """
+    # Create docs/prs directory if it doesn't exist
+    pr_dir = Path("docs/prs")
+    pr_dir.mkdir(parents=True, exist_ok=True)
+
+    # Generate filename with timestamp
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    filename = pr_dir / f"pr_{timestamp}.md"
+
+    # Write the PR description
+    content = f"# {title}\n\n{body}"
+    _ = filename.write_text(content)
+
+    return str(filename)
+
+
+def main():
+    if len(sys.argv) < 3:
+        print("Usage: write_pr_description.py <title> <body>", file=sys.stderr)
+        print("\nExample:", file=sys.stderr)
+        print(
+            '  write_pr_description.py "Add new feature" "## Summary\\n- Added X\\n- Fixed Y"',
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    title = sys.argv[1]
+    body = sys.argv[2]
+
+    filepath = write_pr_description(title, body)
+    print(f"PR description written to: {filepath}")
+    print("\nPlease review and edit the file before creating the PR.")
+
+
+if __name__ == "__main__":
+    main()