Agent Skills › withkynam/vibecode-pro-max-kit › vc-audit-plans

vc-audit-plans

GitHub

审计活跃项目计划文件的陈旧性、完成状态及路由真实性。用于清理计划、对账活跃工作或归档已完成工件，通过验证库存、交叉检查代码库并分类处理来维护项目结构整洁。

.claude/skills/vc-audit-plans/SKILL.md withkynam/vibecode-pro-max-kit

Trigger Scenarios

用户需要定期清理活跃计划更新流程被跳过导致清理滞后批量工作后需对账多个活跃计划清理项目中的过时或重复文件

Install

npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-plans -g -y

More Options

Non-standard path

npx skills add https://github.com/withkynam/vibecode-pro-max-kit/tree/main/.claude/skills/vc-audit-plans -g -y

Use without installing

npx skills use withkynam/vibecode-pro-max-kit@vc-audit-plans

指定 Agent (Claude Code)

npx skills add withkynam/vibecode-pro-max-kit --skill vc-audit-plans -a claude-code -g -y

安装 repo 全部 skill

npx skills add withkynam/vibecode-pro-max-kit --all -g -y

预览 repo 内 skill

npx skills add withkynam/vibecode-pro-max-kit --list

SKILL.md

Frontmatter

{
    "name": "vc-audit-plans",
    "layer": "contract",
    "metadata": {
        "author": "vibecode-pro-max-kit",
        "version": "1.0.0"
    },
    "description": "Audit active project plan files for staleness, completion, and routing truth. Use when cleaning up plans, reconciling active work, or archiving completed artifacts.",
    "trigger_keywords": "audit plans, plan inventory, stale plans, active plan count"
}

Audit Plans

Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.

Use this skill to review active plan artifacts and reconcile them with the current codebase.

This is a maintenance and recovery skill, not an automatic post-task hook.

Optional input: a feature, folder, plan filename, or maintenance scope to prioritize.

Prefer it when:

UPDATE PROCESS was skipped and active-plan cleanup drift accumulated
the user wants a periodic active-plan cleanup pass
multiple active plans need reconciliation after a burst of work

Workflow

Read references/audit-plans.md for the full audit process.

Run the inventory validator:

node .claude/skills/vc-audit-plans/scripts/validate-plan-inventory.mjs

Inventory plans in process/general-plans/active/ and process/features/*/active/. Plans now live inside {slug}_{date}/ task subfolders — scan one level deep. Do NOT count _REPORT_, _REF_, or _SPEC_ files inside task folders as plans; only _PLAN_ files count. For feature-scoped audits, first run find process/features/{feature}/ -type f | sort for full artifact visibility. For full audits, run find process/features/ -type f | sort to see all feature artifacts across all subdirs (active, completed, backlog, references, reports). 3.5. Scan task folder contents (co-located REPORT/REF/SPEC files) alongside each plan. Per task-folder artefact colocation, the correct home for every artefact (plan, spec, reports, references) is INSIDE its {slug}_{date}/ task folder; flag any task artefact found in the deprecated sibling reports//references/ dirs or any ad-hoc location as mis-located, and recommend moving it into the owning task folder. Match by feature slug, date proximity (7 days), or content reference to the plan filename.
Cross-check each plan against the actual codebase with file existence checks and targeted rg searches.
Classify each plan as Completed, Partially Done, Obsolete, Stale, Active, or Reference.
Move only clearly completed or obsolete plans to the appropriate completed/ folder. Use git mv active/{slug}_{date}/ completed/{slug}_{date}/ — move the WHOLE task folder; no completed_ prefix added.
Ask before deleting anything.
Re-run the inventory validator after moving or editing plan files.

Output

Return a concise summary table with classification, action taken, and any user decisions needed. Include stale artifact findings (reports/references tied to completed or obsolete plans) with recommended actions.