AGENT SKILL

speclite-cli-tool-contract-auditor

Audit CLI tool project contracts from repository evidence. Use when a selected other ecosystem module targets bin entries, command surface, TTY or non-TTY output, exit codes, JSON contracts, shell portability, install smoke, or CLI command compatibility.

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

01 前言 Front Matter

name
speclite-cli-tool-contract-auditor
metadata
{ "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
description
Audit CLI tool project contracts from repository evidence. Use when a selected other ecosystem module targets bin entries, command surface, TTY or non-TTY output, exit codes, JSON contracts, shell portability, install smoke, or CLI command compatibility.
allowed-tools
[ "Read", "Write", "Bash", "Grep", "Glob" ]

02 资源文件 3

03 SKILL.md 正文

Speclite CLI Tool Contract Auditor

[Overview(技能说明)] Speclite CLI Tool Contract Auditor 是 ecosystem-other-cli-tool module 的项目形态审计工作流。它面向已选择 CLI tool other ecosystem module 的目标项目,围绕 bin entry、command surface、TTY / non-TTY output、exit codes、JSON contract、shell portability 和 install smoke 建立证据。

[Core Capabilities(核心能力)] - CLI boundary discovery(CLI 边界发现):读取 package.json、manifest、entry files、command parser、README、shell scripts、tests 和 CI。 - Command surface audit(命令面审计):记录 command/subcommand/options/args、help output、error output、JSON mode 和 stable compatibility promises。 - Runtime behavior evidence(运行行为证据):区分 TTY / non-TTY、stdout / stderr、exit code、signal handling、shell portability 和 path assumptions。 - Install smoke planning(安装冒烟规划):规划 clean install、global/local invocation、npx / direct bin / package manager exec 的验证路径。 - Boundary protection(边界保护):通用 CLI 输出布局、Story 开发和 Code Review workflow 仍留在 sdlc。

[Workflow(执行流程)] 详细步骤见 references/cli-tool-contract-audit-workflow.md。

1. 确认 `{project-root}`、CLI package root、目标 command 和输出位置。
2. 收集 CLI evidence:manifest `bin`、entry files、command parser、README、tests、fixtures、CI 和 install instructions。
3. 只记录可验证事实;command surface、exit codes、JSON contract 和 shell portability 必须来自代码、测试、文档或命令输出。
4. 输出 CLI contract audit note,覆盖 command surface、I/O behavior、install smoke plan、compatibility risks 和 unknowns。
5. 如需实现或修复 CLI 行为,交给 Dev Story / Quick Dev / Code Review 等 `sdlc` workflow。

[Notes(注意事项)] - 本 Skill 不替代通用 CLI human output 或 implementation workflow。 - 不从 README 示例反推出未实现行为;文档和真实 command behavior 冲突时必须标记 drift。 - 对跨 shell 行为必须明确平台、shell、Node/runtime 和 package manager evidence。

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