mj-agent-flow-repo-scan

Verifies plans against mj-agent repository state before implementation begins.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-flow-repo-scan-mj-agentlab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mj-agent-flow-repo-scan
Source: https://github.com/MJ-AgentLab/mj-agent/tree/main/.claude/skills/mj-agent-flow-repo-scan
Command: npx skills add https://github.com/MJ-AgentLab/mj-agent --skill mj-agent-flow-repo-scan-mj-agentlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before writing a Plan, SPEC, or code for the mj-agent data agent, teams need to confirm that the Issue and Plan still match the actual repository state. This Skill performs a read-only fact-check across code, configuration, business catalog, tests, and documentation so downstream stages start from verified evidence rather than stale assumptions. ## Core Features & Use Cases - 8-dimension repository scan: Covers the seven mj-agent source modules, LangGraph Studio and Chainlit surfaces, real biz data flow, databases, configuration and secrets, tests, and documentation governance. - Reverse stale-doc scan: Greps docs, SKILL.md files, and prompts for renamed functions, moved files, and renamed SQL objects, plus biz_catalog drift detection via scripts/diff_biz_schema.py. - Documentation Decision matrix: Produces a 10-row Create/Update/None decision table across Plan, SPEC, ADR, RUNBOOK, GUIDE, STANDARD, ISSUE, ASSESSMENT, CHANGELOG, and INDEX document types. - Use Case: A developer says "按 plan 实施" on an existing branch; the Skill scans the worktree, confirms the Plan still holds, escalates risk if runtime SKILL.md or prompt versions changed, and outputs a Repo Scan Result with HITL questions before any code is written. ## Quick Start Ask the assistant to run a repo scan against the current branch and Issue before starting implementation, for example by saying "开始执行,先做一次 repo scan".

Frequently Asked Questions about mj-agent-flow-repo-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a plan against the current repository state before coding?▼

Run the repo scan after a branch is created and before writing a Plan or SPEC. It reads tracking anchors, captures worktree state with git status and merge-base diffs, scans eight dimensions, and outputs a Plan Verdict indicating whether the plan still holds.

What is a reverse stale-doc scan in a repository audit?▼

A reverse scan greps documentation, SKILL.md files, and prompts for references to renamed functions, moved files, or renamed SQL objects. Each hit is recorded as an Update action in the Documentation Decision matrix with the grep command and line numbers as evidence.

Does the repo scan modify any files in the repository?▼

No, the scan is strictly read-only. It uses git status, git diff, Glob, Grep, and Read operations plus a schema diff script, and outputs the Repo Scan Result only in conversation without editing code, docs, config, or the biz catalog.

When is a full repo scan not required before implementation?▼

A full scan can be skipped for pure documentation typo fixes, low-risk single-file changes under 50 lines, or conceptual questions. These cases still require a minimal targeted check of the affected module, tests, and directly related documents.

Why does risk automatically escalate to High during a repo scan?▼

Risk escalates to High when the scan touches any of four mandatory-stop areas: runtime SKILL.md body changes, prompt version bumps, biz_catalog synchronization, or SQL guardrail relaxation. Production secrets and CI/CD release paths also trigger automatic escalation with mandatory human confirmation.