AGENT SKILL

speclite-npm-package-project-auditor

Audit npm package project facts before release planning. Use when a selected other ecosystem module targets an npm package, package.json, package surface, tarball smoke, npx smoke, library entrypoint, CLI bin, publish metadata, or release gate readiness. This is an evidence audit companion and does not run npm publish.

License 许可
MIT
所属仓库
flanliulf/SpecLite
最近更新
2026-11-12
Stars
★ 4
Forks
0

01 前言 Front Matter

name
speclite-npm-package-project-auditor
metadata
{ "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
description
Audit npm package project facts before release planning. Use when a selected other ecosystem module targets an npm package, package.json, package surface, tarball smoke, npx smoke, library entrypoint, CLI bin, publish metadata, or release gate readiness. This is an evidence audit companion and does not run npm publish.
allowed-tools
[ "Read", "Write", "Bash", "Grep", "Glob" ]

02 资源文件 3

03 SKILL.md 正文

Speclite Npm Package Project Auditor

[Overview(技能说明)] Speclite Npm Package Project Auditor 是 ecosystem-other-npm-package module 的项目形态审计工作流。它面向已选择 npm package other ecosystem module 的目标项目,围绕 package.json、package manager、publish metadata、package surface、tarball / npx smoke 和 release gate readiness 建立证据。

[Core Capabilities(核心能力)] - Package fact discovery(包事实发现):读取 package.json、lockfile、workspace 配置、README、LICENSE、exports、types、bin、files 和 publish metadata。 - Package surface audit(包面审计):区分 library entrypoint、CLI bin、dual package、type declarations、public files 和 package-facing docs。 - Smoke evidence planning(冒烟证据规划):规划 npm pack tarball inspection、clean install、npx smoke、library import smoke 或 CLI smoke,但不默认发布。 - Release gate mapping(发布门禁映射):把项目已有 build/test/lint/typecheck/release scripts 映射为 release readiness evidence。 - Boundary protection(边界保护):保留 speclite-npm-publisher 在 sdlc,需要真实发布时转交该 DevOps workflow。

[Workflow(执行流程)] 详细步骤见 references/npm-package-project-audit-workflow.md。

1. 确认 `{project-root}`、目标 package root 和输出位置;如果 monorepo 中 package 未明确,先让用户指定。
2. 读取 package facts:`package.json`、lockfile、workspace config、README、LICENSE、source entrypoints、dist files、CI 和 release scripts。
3. 只记录可验证事实;package manager、registry、exports、bin、files 和 version 结论必须来自真实文件或命令输出。
4. 生成 audit note,覆盖 package surface、tarball / `npx` / library smoke plan、release gate readiness、unknowns 和 handoff。
5. 如果用户明确要发布,停止本 Skill 并建议运行 `speclite-npm-publisher`,不要在本 workflow 中执行 `npm publish`。

[Notes(注意事项)] - 本 Skill 不迁移、不复制 speclite-npm-publisher;它只提供 npm package project shape audit。 - 不猜测 registry、版本、package manager 或 publish access;必须从项目文件、命令输出或用户提供资料取证。 - 若 package 是 private、unpublished、workspace-only 或 docs-only,记录边界并避免把 release action 写成已授权事实。

04 同仓库更多 Skills

flanliulf
flanliulf/SpecLite

speclite-dev-story

暂无简介

★ 4
flanliulf
flanliulf/SpecLite

speclite-code-review-01-reviewer

Fixture-owned installed skill entry for the minimal artifact loop.

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-lint

只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。

★ 4
flanliulf
flanliulf/SpecLite

speclite-skill-creator

创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。

★ 4
flanliulf
flanliulf/SpecLite

speclite-html-ppt-generator

生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。

★ 4
flanliulf
flanliulf/SpecLite

speclite-docs-intro-ppt-creator

生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。

★ 4