python-shell
Skill8 starsChanged 5 months agoMITView on GitHub
开发或评审 Python CLI、Shell 脚本及 YAML 配置与渲染,覆盖输入契约、解析、重试、错误和退出码。
In this repository68 other files it gives its agents.
- animejsSkill
- sketch-animation-videoSkill
- sound-fx-for-videoSkill
- content_series_infographicSkill
- tech-article-seriesSkill
- ansible-playbookSkill
- gin-goSkill
- github-actionsSkill
- iac-hclSkill
- nodejs-nextjs-typescriptSkill
- postgresql-developmentSkill
- programming-paradigmsSkill
- agent-team-harnessSkill
- ai-agent-collaboration-standardSkill
- ci-cd-workflow-specSkill
- config-as-code-specSkill
- execution-ownership-migrationSkill
- feature-lane-release-workflowSkill
- generation-upgrade-acceptanceSkill
- gitops-canonical-resource-deliverySkill
- harness-workflowSkill
- infrastructure-as-code-specSkill
- issue-pr-traceability-standardSkill
- multi-environment-delivery-and-releaseSkill
- project-development-standardSkill
- store-and-startup-homepage-specSkill
- zero-trust-overlay-deliverySkill
- it-infra-continuous-pngSkill
- image-svg-pptx-proSkill
- autoglm-websearchSkill
- blogwatcherSkill
- Browser AutomationSkill
- docxSkill
- find-skillsSkill
- image-cogSkill
- image-resizerSkill
- pdfSkill
- pptxSkill
- Self-Improving Agent (With Self-Reflection)Skill
- skill-security-checkSkill
- skill-vetterSkill
- video-translatorSkill
- wan-image-video-gen-editSkill
- xlsxSkill
- backup-disaster-recovery-and-data-migrationSkill
- capacity-cost-and-resource-lifecycleSkill
- github-actions-operational-dispatchSkill
- incident-response-and-change-managementSkill
- network-dns-tls-edge-managementSkill
- observability-slo-and-alertingSkill
- secrets-identity-and-access-governanceSkill
- service-catalog-and-runbook-standardSkill
- system-db-three-role-securitySkill
- unified-observability-architectureSkill
- vault-eso-tls-certificate-governanceSkill
- ai-tech-news-videoSkill
- ai-ti-wo-shuo-explainerSkill
- it-infra-evolution-videoSkill
- it-infra-evolution-video-v2Skill
- product-intro-videoSkill
- The first 60 shown.
The file
Files
Python / Shell / YAML 开发规范
- Shell 用于串联已有命令、传递参数与简单条件。结构化解析、复杂校验、可独立测试的决策和多步恢复优先 Python。主机收敛优先 Ansible 模块。先查现有 CLI、脚本和调用链,复用所属仓库的实现。
- 入口参数明确目标、路径与模式。保留现有 CLI 参数、输出格式和退出码契约。机器可读结果输出到 stdout,诊断输出到 stderr。副作用脚本应区分成功、无需变更、失败及部分完成,具体表达沿用调用方契约。
- Shell 选择实际支持的解释器,正确引用参数,按解释器能力传递参数列表。检查命令与管道失败,避免通过
eval拼装命令。Python 用结构化解析和参数数组调用子进程,显式处理退出状态与超时。 - 分离解析、业务决策与副作用。渲染文件先验证再写入,需避免半写时在同文件系统内原子替换。涉及共享状态时,明确互斥、幂等或恢复点。只重试暂时性且可安全重试的操作,保留首个可定位的失败原因。
- 用脚本实际入口验证成功和至少一个受影响的失败路径。按需覆盖空输入、特殊字符、重复执行、部分失败及错误传播到调用方。沿用仓库现有格式化、ShellCheck 或 Python 测试入口。
YAML 与渲染
- YAML 描述结构化输入,Python 负责解析和契约校验,Shell 负责调用。按实际消费者确认单文档或多文档格式、标量类型、空值及默认值。GitHub Actions 和 Ansible 的框架语义使用各自解析器验证。
- 对部署拓扑、访问策略等会影响实际目标的声明,在消费边界拒绝重复键和无效引用。用合成样本验证解析器行为,覆盖最后一个值覆盖前值的情形。跨文件的唯一性按资源类型和作用域验证,允许契约明确的覆盖。
- 验证解析后的数据和下游渲染结果。生成的 JSON、HCL 或 inventory 由权威声明派生。临时产物不承担环境事实源职责。
命名与可读性按清单执行:Python 与 Shell 函数用 snake_case,常量 UPPER_SNAKE_CASE,YAML 键与 Ansible 变量用下划线。脚本文件名跟随所在目录已有的下划线或连字符风格,不引入第三种写法。避免晦涩的一行条件和 eval;复杂逻辑写成可测试的小函数。
工作流或 Playbook 调用分别参考 GitHub Actions及 Ansible Playbook。涉及语言选择或复用边界时,读取范式与模式选择。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

