universal-dev-standards 5.1.0 → 5.2.0

package/bundled/skills/push/SKILL.md

@@ -0,0 +1,203 @@
+---
+name: push
+scope: universal
+description: |
+  AI-assisted safety layer for git push operations with quality gates and collaboration guardrails.
+  Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
+  Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保護分支, 品質閘門.
+allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
+argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
+---
+
+# Push Assistant | 推送助手
+
+> **Language**: English | 繁體中文
+
+**Version**: 1.0.0
+**Created**: 2026-04-23
+**Applicability**: Claude Code Skills
+
+---
+
+AI-assisted safety layer for `git push`. Detects protected branches, enforces force-push guardrails, runs pre-push quality gates, outputs a structured push receipt, and integrates with PR automation.
+
+`git push` 的 AI 輔助安全層。偵測保護分支、強制 force-push 護欄、執行 pre-push 品質 gate、輸出結構化推送收據，並整合 PR 自動化。
+
+## Core Standard | 核心標準
+
+This skill implements [`.standards/push-standards.ai.yaml`](../../.standards/push-standards.ai.yaml).
+
+---
+
+## Features | 功能說明
+
+### 1. Push Target Risk Detection | 推送目標風險偵測
+
+Before pushing, the assistant detects whether the target branch is a protected branch (e.g., `main`, `master`, `release/*`, `hotfix/*`).
+
+推送前偵測目標分支是否為保護分支（例如 `main`、`master`、`release/*`、`hotfix/*`）。
+
+- Displays a **warning** with branch name and commit list
+- Requires explicit user confirmation before proceeding
+- Aborts push if user does not confirm
+
+### 2. Force-Push Guardrails | Force-Push 護欄
+
+When `--force` is detected, shows the impact before allowing execution.
+
+偵測到 `--force` 時，推送前顯示影響範圍。
+
+- Calculates commits that will be overwritten on remote
+- Shows count and authors of overwritten commits
+- Requires user to type a confirmation string (`yes, force push`)
+- Records `force_push: true` in the push receipt
+
+### 3. Pre-Push Quality Gates | Pre-Push 品質 Gate
+
+Runs configured quality gates in sequence before pushing.
+
+推送前依序執行已設定的品質 gate。
+
+| Gate | Description | 說明 |
+|------|-------------|------|
+| `lint` | Run project lint command | 執行 lint 檢查 |
+| `test` | Run project test command | 執行測試 |
+| `type-check` | TypeScript type checking (optional) | TypeScript 型別檢查（選用） |
+| `ac-coverage` | Acceptance criteria coverage check (optional) | AC 覆蓋率檢查（選用） |
+| `security-scan` | Security vulnerability scan (optional) | 安全掃描（選用） |
+
+### 4. Push Receipt | 推送收據
+
+After a successful push, outputs a structured receipt for audit trail purposes.
+
+推送成功後輸出結構化收據，供稽核追蹤使用。
+
+```json
+{
+  "branch": "feature/my-feature",
+  "commit_sha": "a1b2c3d",
+  "gates_passed": ["lint", "test"],
+  "gates_skipped": false,
+  "force_push": false,
+  "timestamp": "2026-04-23T10:00:00Z",
+  "target_remote": "origin"
+}
+```
+
+Optionally appended to `~/.uds/push-history.jsonl` for persistent audit trail.
+
+可選擇附加到 `~/.uds/push-history.jsonl` 以持久化稽核追蹤。
+
+### 5. PR Automation Integration | PR 自動化整合入口
+
+After pushing a feature branch, prompts user to create a Pull Request if none exists.
+
+推送 feature branch 後，若尚無 PR，提示使用者建立 Pull Request。
+
+- Checks if an open PR exists for the branch
+- Prompts user to run `pr-automation-assistant`
+- Skipped in `single-owner` repo mode or when `--no-pr` flag is used
+
+---
+
+## Usage | 使用方式
+
+```bash
+# Standard push (runs quality gates automatically)
+/push
+
+# Push with force (shows overwritten commits, requires confirmation)
+/push --force
+
+# Push to a specific remote branch
+/push --target main
+
+# Skip quality gates (emergency use)
+/push --skip-gates
+
+# Push without PR prompt
+/push --no-pr
+
+# Force push without PR prompt (e.g., updating a personal branch)
+/push --force --no-pr
+```
+
+## Arguments | 參數說明
+
+| Argument | Description | 說明 |
+|----------|-------------|------|
+| `--force` | Enable force push with guardrail checks | 啟用 force push，含護欄確認 |
+| `--target <branch>` | Specify target remote branch explicitly | 明確指定目標遠端分支 |
+| `--skip-gates` | Skip pre-push quality gates (emergency only) | 跳過品質 gate（僅緊急情況） |
+| `--no-pr` | Suppress PR automation prompt after push | 推送後不提示建立 PR |
+
+---
+
+## Configuration | 設定
+
+Configure via `uds.project.yaml`:
+
+```yaml
+push:
+  repo_mode: team           # "team" | "single-owner"
+  protected_branches:
+    - main
+    - master
+    - "release/*"
+    - "hotfix/*"
+  push_gates:
+    default:
+      - lint
+      - test
+    optional:
+      - type-check
+      - ac-coverage
+      - security-scan
+  receipt:
+    output: console          # "console" | "file" | "both"
+    file_path: "~/.uds/push-history.jsonl"
+  auto_pr: true              # prompt to create PR after push to non-protected branch
+```
+
+### Options | 選項模式
+
+| Option File | Mode | Description | 說明 |
+|-------------|------|-------------|------|
+| [`options/push/team-mode.md`](../../options/push/team-mode.md) | `team` | Full collaboration guardrails (default) | 完整協作護欄（預設） |
+| [`options/push/single-owner-mode.md`](../../options/push/single-owner-mode.md) | `single-owner` | Reduced friction for personal repos | 個人 repo 低摩擦模式 |
+
+---
+
+## Next Steps Guidance | 下一步引導
+
+After `/push` completes, the AI assistant should suggest:
+
+> **推送完成。建議下一步 / Push complete. Suggested next steps:**
+> - 執行 `/pr-automation-assistant` 建立或更新 Pull Request ⭐ **Recommended / 推薦** — 確保協作流程完整 / Ensure complete collaboration workflow
+> - 執行 `/checkin` 確認程式碼簽入品質 — 下次提交前的品質確認 / Quality verification before next commit
+> - 查看 `~/.uds/push-history.jsonl` 確認推送紀錄 — 稽核追蹤 / Audit trail verification
+
+---
+
+## Related Standards | 相關標準
+
+- [Push Standards](.standards/push-standards.ai.yaml) — Core push safety rules
+- [Git Workflow](../../.standards/git-workflow.ai.yaml) — Branching strategy
+- [Commit Message](../../.standards/commit-message.ai.yaml) — Commit conventions
+- [PR Automation](../pr-automation-assistant/SKILL.md) — Pull Request automation
+
+---
+
+## Version History | 版本歷程
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2026-04-23 | Initial release — XSPEC-081 Phase 1 |
+
+---
+
+## License | 授權
+
+This skill is released under [MIT License](https://opensource.org/licenses/MIT) and [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/skills/testing-guide/SKILL.md

@@ -1,4 +1,5 @@
 ---
+name: testing-guide
 scope: uds-specific
 description: |
   Testing pyramid and test writing standards for UT/IT/ST/E2E.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",
@@ -59,7 +59,7 @@
     "prepack": "node scripts/prepack.mjs"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.3.2",
+    "@inquirer/prompts": "8.4.1",
     "chalk": "^5.3.0",
     "commander": "^14.0.0",
     "js-yaml": "^4.1.0",
@@ -70,9 +70,9 @@
     "@vitest/coverage-v8": "^4.1.2",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "eslint": "^10.1.0",
+    "eslint": "10.2.1",
     "glob": "^13.0.1",
-    "globals": "^17.4.0",
+    "globals": "17.5.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
     "vitest": "^4.1.2"

package/src/config/ai-agent-paths.js

@@ -2,7 +2,6 @@
  * AI Agent Paths Configuration
  *
  * Centralized configuration for all supported AI coding assistants.
- * Based on docs/AI-AGENT-ROADMAP.md specifications.
  *
  * @version 1.0.0
  */

package/src/utils/directory-mapper.js

@@ -9,7 +9,7 @@
  */
 
 import { readdirSync } from 'fs';
-import { join, relative } from 'path';
+import { join, relative, basename } from 'path';
 
 /**
  * Default mappings from standard IDs to directory glob patterns.
@@ -84,7 +84,7 @@ export function mapStandardsToDirectories(projectPath, customMappings = {}) {
     const matchedDirs = [];
 
     for (const dir of projectDirs) {
-      const dirName = dir.split('/').pop();
+      const dirName = basename(dir);
       if (patterns.includes(dirName)) {
         matchedDirs.push(dir);
       }

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "lastUpdated": "2026-04-16",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,14 +58,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "5.1.0"
+      "version": "5.2.0"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "5.1.0",
+      "version": "5.2.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -704,6 +704,17 @@
       "skillName": "ai-collaboration-standards",
       "description": "Guidelines for AI collaboration to prevent hallucination and ensure evidence-based responses"
     },
+    {
+      "id": "agent-behavior-discipline",
+      "name": "Agent Behavior Discipline",
+      "nameZh": "Agent 行為紀律標準",
+      "source": {
+        "human": "core/agent-behavior-discipline.md",
+        "ai": "ai/standards/agent-behavior-discipline.ai.yaml"
+      },
+      "category": "core",
+      "description": "Four behavioral disciplines for AI agents: Ask (surface assumptions), Simple (minimum code), Precision (scope only what's needed), Test (loop until verified)"
+    },
     {
       "id": "ai-friendly-architecture",
       "name": "AI-Friendly Architecture",
@@ -2053,4 +2064,4 @@
       "description": "MISSING vs OUTDATED distinction, semver-aware severity (PATCH/MINOR/MAJOR), and automation integration (pre-commit hook, release gate) for multi-locale documentation"
     }
   ]
-}
+}