Agent Skills
返回列表
💻

Anvil 终端 CLI/TUI 工具开发

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @org-02qudk26/anvil1。

技能介绍

解决什么问题

很多命令行工具能跑通 happy path，却在 --help 缺失、退出码随意、管道环境里卡住、--json schema 漂移等问题上反复返工。Anvil 关注的是把终端接口当作稳定契约：命令签名、子命令、flag、环境变量、配置文件格式和机器可读输出都不能靠临场发挥。

技能如何工作

它先锁定 BLUEPRINT 阶段的命令契约，再逐步实现骨架、TTY 感知交互与失败路径。

  • 命令设计：子命令结构、flag 约定、--help、--version、POSIX 风格退出码。
  • TUI 交互：spinner、progress bar、table、selection menu，并保持 --no-color 与 non-TTY fallback。
  • 自动化兼容：默认人类可读输出，--json 作为稳定 API 契约；提供 --no-prompt 或 --no-interactive 供 CI 与 agent 调用。
  • 工具链集成：shell completion、config precedence、doctor checks、Homebrew/deb/npm/cargo 等分发路径。

适用边界

适合 CLI/TUI 实现与审查，不适合纯业务逻辑、完整 CI 编排或深度文档写作。涉及破坏既有命令接口、新增依赖、全局配置或阻塞式交互时，应先确认影响面。

使用场景

  • 为内部构建工具设计子命令、flag、help 与 exit code，并补充 --json 输出契约。
  • 在 CI 非 TTY 环境中运行 CLI，需要支持 --no-prompt、--no-color 和稳定 JSON 输出。
  • 为 Bash、Zsh、Fish、PowerShell 生成 shell completion，并纳入 CI 防漂移检查。
  • 给已有 linter 或 test runner 包一层命令，实现 doctor 检查和配置优先级链。

适合人员

  • 负责命令行工具接口的工程师：要把 flags、help、exit code 和 --json 契约设计清楚。
  • 维护内部开发者工具的平台工程师：需要支持 CI、non-TTY、shell completion 与配置优先级。
  • 做终端产品交互的 TUI 工程师：要处理 prompt、progress、table 和非交互降级。
  • 负责工具打包发布的 DevOps 工程师：要处理 Homebrew、deb、npm/cargo 分发与安装脚本。