scenario_191.json

{
  "scenario": {
    "id": "scenario_191",
    "title": "Good First Issue: Add Chinese (zh-CN) translation of README.md",
    "ring": "Ring-3",
    "ring_label": "🌱 Open — Everyone",
    "description": "A complete walkthrough of a Ring-3 (Good First Issue) contribution lifecycle, from issue discovery to PR merge, demonstrating the automated CI/CD pipeline and human-in-the-loop review.",
    "tags": ["good-first-issue", "documentation", "i18n", "beginner-friendly"],
    "estimated_effort": "30 minutes"
  },
  "agent": {
    "name": "baobao",
    "github_login": "mkcash",
    "type": "human-assisted",
    "level": "Lv.1 — First Contribution"
  },
  "maintainer": {
    "github_login": "Ikalus1988",
    "role": "project-owner"
  },
  "pipeline": {
    "total_steps": 8,
    "steps": [
      {
        "stage": 1,
        "stage_name": "discover",
        "label": "发现 Issue",
        "description": "Agent scans the repository for open issues and finds #191 labeled 'good first issue'.",
        "ring": "Ring-3",
        "icon": "🔍"
      },
      {
        "stage": 2,
        "stage_name": "claim",
        "label": "留言 /claim",
        "description": "Contributor comments /claim on the issue to lock a 8-hour exclusive implementation window.",
        "ring": "Ring-3",
        "icon": "✋"
      },
      {
        "stage": 3,
        "stage_name": "welcome",
        "label": "Bot 欢迎",
        "description": "newbie-welcome.yml workflow auto-replies with a newcomer guide, including contribution steps and star prompt.",
        "ring": "Ring-3",
        "icon": "🤖",
        "workflow": ".github/workflows/newbie-welcome.yml"
      },
      {
        "stage": 4,
        "stage_name": "fork-and-dev",
        "label": "Fork & 开发",
        "description": "Contributor forks the repo, creates a feature branch, implements the changes with git commit -s (Signed-off-by).",
        "ring": "Ring-3",
        "icon": "🔄"
      },
      {
        "stage": 5,
        "stage_name": "submit-pr",
        "label": "提交 PR",
        "description": "Contributor pushes the branch and opens a Pull Request. CI workflows are triggered automatically.",
        "ring": "Ring-3",
        "icon": "📤"
      },
      {
        "stage": 6,
        "stage_name": "dco-check",
        "label": "DCO 检查",
        "description": "dco-check.yml validates that every commit includes a Signed-off-by trailer. If missing, github-actions[bot] posts a structured remediation comment with exact git commands.",
        "ring": "Ring-3",
        "icon": "🔒",
        "workflow": ".github/workflows/dco-check.yml",
        "on_failure": "Bot posts remediation: git rebase --signoff + git push --force"
      },
      {
        "stage": 7,
        "stage_name": "ci-audit",
        "label": "CI 审计",
        "description": "pr-checks.yml runs the full audit suite: Agent Quality Score, PR size check, pytest + coverage, Shadow Branch isolation, Auto-Merge Gate.",
        "ring": "Ring-3",
        "icon": "🧪",
        "workflow": ".github/workflows/pr-checks.yml",
        "checks": [
          {"name": "Agent Quality Score", "threshold": "≥40/100"},
          {"name": "PR Size Check", "threshold": "≤10 files, ≤500 lines"},
          {"name": "Test Suite", "command": "pytest", "coverage_min": "20%"},
          {"name": "Shadow Branch Isolation", "description": "External code evaluated in isolated branch"},
          {"name": "DCO / Signed-off-by", "description": "All commits must be signed"}
        ]
      },
      {
        "stage": 8,
        "stage_name": "merge",
        "label": "合并 🎉",
        "description": "Human maintainer reviews and merges the PR. Auto-Merge Gate enables automatic merge when all conditions are met.",
        "ring": "Ring-3",
        "icon": "✅",
        "human_review_required": true
      }
    ]
  },
  "links": {
    "issue": "https://github.com/Ikalus1988/MisakaNet/issues/191",
    "pull_request": "https://github.com/Ikalus1988/MisakaNet/pulls?q=author%3Amkcash",
    "contributor_profile": "https://github.com/mkcash",
    "live_demo": "https://misakanet.org/journey/"
  },
  "metadata": {
    "schema_version": "misaka-journey-v1",
    "generated_at": "2026-06-12T16:00:00Z",
    "description": "Machine-readable scenario manifest for AI agents. Parsed by autonomous agents to understand MisakaNet's contribution lifecycle."
  }
}