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

触发场景

需要定期清理活跃计划时跳过更新流程导致计划漂移积累时批量工作后需对多个活跃计划进行核对时用户明确要求执行计划维护或清理任务时

安装

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

更多选项

非标准路径

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

不安装直接使用

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.