关于 project-min-evaluation
project-min-evaluation 是用于在报告实现完成或提交前核验项目质量的技能。它识别包管理器,只运行项目已定义且适用的脚本,并在首次失败时停止。
主要功能
- 01识别包管理器
- 02查找已定义的质量脚本
- 03按顺序执行脚本
- 04检查失败即停止
- 05结构化报告核验结果
适用场景
- 01标记完成前检查工作
- 02提交前验证改动
- 03报告缺失或失败的检查
- 04选择项目定义的测试命令
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ c3sc0-v4113/ scaffold --skill project-min-evaluation安装后在 Claude Code 中输入/project-min-evaluation确认已加载。
附带文件references/script-discovery.md
详细介绍
项目最低评估要求
激活约定
在报告实现工作已完成之前、提交之前,或有人要求验证质量时,加载此技能。
硬性规则
- 根据项目识别包管理器;绝不硬编码运行器。
- 仅运行
package.json中scripts定义的脚本;对于缺失的预期脚本,报告其缺失,而不是自行编造命令。 - 按照下方顺序从仓库根目录运行,不得跳过失败的步骤以执行后续步骤。
- 如果检查失败或未运行,绝不声称工作已完成。
决策门
| 项目信号 | 运行器 |
|---|---|
package.json 中有 packageManager 字段 | 使用其中指定的管理器 |
pnpm-lock.yaml | pnpm run <script> |
bun.lock 或 bun.lockb | bun run <script> |
package-lock.json,或没有其他信号 | npm run <script> |
| 脚本 | 运行条件 |
|---|---|
lint | 始终运行,前提是已定义 |
typecheck | 始终运行,前提是已定义 |
format:check | 始终运行,前提是已定义 |
test | 始终运行,前提是已定义 |
doctor | 始终运行,前提是已定义 |
check | 始终运行,前提是已定义(聚合门) |
test:e2e | 仅在端到端行为发生变化时运行 |
执行步骤
- 阅读
package.json和锁文件,选择运行器。 - 收集表格中已在
scripts中定义的脚本。 - 使用选定的运行器,按表格顺序运行每个已定义的脚本。
- 遇到第一个失败时停止,修复问题,然后从该脚本开始重新运行。
输出约定
将每个脚本报告为通过、失败或未定义。对于失败或无法运行的检查,提供准确的命令、准确的错误以及尚未验证的范围。
参考资料
- references/script-discovery.md — 检测边缘情况。
评论
支持 Markdown