Project Min Evaluation

C3SC0-V4113/Scaffold/skills/project-min-evaluation

作者 C3SC0-V4113ba1fac59145ed48f727247299ebb09289b87f27bApache-2.03 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫3 天前更新

Trigger: done, complete, finish, before commit, quality check, verify. Run the project's own minimum quality scripts before claiming work is complete.

AI 產生的概覽

在聲稱工作完成前,執行專案本身的最低品質檢查指令碼。

功能
此技能引導代理偵測專案的套件管理器,收集 package.json 中定義的品質指令碼,並依固定順序執行,之後才聲稱實作工作已完成。它會在第一次失敗時停止,並將每個指令碼回報為通過、失敗或未定義,失敗時提供確切指令與錯誤。它產出的是驗證報告,而非程式碼變更。
適用情境
適用於在回報實作工作完成前、提交前,或被要求驗證專案品質時。適合在 package.json 中定義了 lint、typecheck、format、test 等指令碼的 JavaScript 或 TypeScript 專案。
執行需求
此技能不隨附指令碼,僅為說明文件。它需要存取專案的 package.json 與鎖定檔,需要 npm、pnpm 或 bun 等套件管理器,且專案本身需定義品質指令碼。

Project Minimum Evaluation

Activation Contract

Load this skill before reporting implementation work as complete, before committing, or when asked to verify quality.

Hard Rules

  1. Detect the package manager from the project; never hardcode a runner.
  2. Run only scripts defined in package.json scripts; report expected scripts that are missing instead of inventing commands.
  3. Run from the repository root, in the order below, and do not skip a failing step to reach a later one.
  4. Never claim completion while a check fails or was not run.

Decision Gates

Project signalRunner
packageManager field in package.jsonuse the manager it names
pnpm-lock.yamlpnpm run <script>
bun.lock or bun.lockbbun run <script>
package-lock.json, or no other signalnpm run <script>
ScriptRun when
lintalways, if defined
typecheckalways, if defined
format:checkalways, if defined
testalways, if defined
doctoralways, if defined
checkalways, if defined (aggregate gate)
test:e2eonly when end-to-end behavior changed

Execution Steps

  1. Read package.json and the lockfiles to choose the runner.
  2. Collect the scripts from the table that exist in scripts.
  3. Run each existing script in table order with the chosen runner.
  4. Stop at the first failure, fix it, and rerun from that script.

Output Contract

Report each script as passed, failed, or not defined. For a failure or a check that cannot run, give the exact command, the exact error, and the unverified scope.

References

  • references/script-discovery.md [blocked] — detection edge cases.

來源與署名

來源:C3SC0-V4113/Scaffold位於skills/project-min-evaluation提交ba1fac5

授權條款: Apache-2.0

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架