Agent写作

Name: Agent写作
Author: ansys

写作社区

作者仓库星标 494
作者更新于实时读取
作者仓库 pymapdl

流狐档案事实层信息：领域、Agent、信任分、运行环境、权限与网络

领域: 写作
兼容 Agent: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
信任分: 88 / 100 · 社区维护
作者 / 版本 / 许可: @ansys · 未声明 license
Token 消耗评级: 低消耗
接入复杂程度: 需简单配置
是否需要外部 API Key: 不需要
兼容的系统: macOS · Linux · Windows
底层运行要求: Python
文件与系统权限: 只读
允许写入 / 修改
Shell 执行
读取环境变量
网络行为: 仅限本地
安装命令数: 26 条

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 pymapdl-cli-ansys.preview

---
name: pymapdl-cli
description: How to use the PyMAPDL command-line interface to start, stop, list, and execute commands on MAPD…
category: 写作
runtime: Python
---

# pymapdl-cli 输出预览

## PART A: 任务判断
- 适用问题：文章、文案、发言稿、润色或结构化表达。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“Commands at a glance / pymapdl start / Key options”读取原文规则，不把推断写成作者承诺。

## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于文章、文案、发言稿、润色或结构化表达，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“Commands at a glance / pymapdl start / Key options”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、执行终端命令、读取环境变量、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。

## Running Rules
- 读取文件、写入/修改文件、执行终端命令、读取环境变量；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。

SKILL.md SKILL.md

---
name: pymapdl-cli
description: How to use the PyMAPDL command-line interface to start, stop, list, and execute commands on MAPD…
category: 写作
source: ansys/pymapdl
---

# pymapdl-cli

## 什么时候使用
- pymapdl-cli 是写作方向的技能，帮你打磨文章、稿子、内容表达 适合处理文章、文案、润色、翻译、总结和结构化表达，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继…
- 面向文章、文案、发言稿、润色或结构化表达，优先处理能明确输入、步骤和验收标准的工作。

## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。

## 执行规则
- 围绕「Commands at a glance / pymapdl start / Key options」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令、读取环境变量；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。

## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。

证据边界与执行链路

作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。

skill "pymapdl-cli" {
  输入层     -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
  上下文层   -> Commands at a glance / pymapdl start / Key options
  规则层     -> SKILL.md 触发条件 / 执行顺序 / 输出格式
  运行层     -> Python | 读取文件、写入/修改文件、执行终端命令、读取环境变量 | 主要在本地完成
  安全层     -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
  输出层     -> 可复制结果 + 检查清单 + 下一步迭代
}

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

先判断是否适合

核心用途：pymapdl-cli 是写作方向的技能，帮你打磨文章、稿子、内容表达适合处理文章、文案、润色、翻译、总结和结构化表达，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。把任务拆成可执行、可检查、可继续迭代的步骤；通常不…
适用任务：更适合文章、文案、润色、翻译、总结和结构化表达，尤其是输入、步骤、验收口径可以反复复用的场景。
不宜硬套：如果任务只有一次性问答、来源材料很少，或需要作者没有说明的命令和外部服务，应先降级为普通对话。

作者设计意图

触发依据：使用时机、上下文收集、输出格式和失败处理共同决定它是否适合当前任务。
来源边界：作者原文负责事实，仓库文件负责命令和文件证据；Fluxly 只补充用途、限制和使用判断。

作者的方法与取舍

执行主线：任务围绕「Commands at a glance / pymapdl start / Key options」组织，把触发条件、必要上下文、执行规则和交付标准连成一条可复核的链路。
设计重点：重点不在重复教程，而在解释作者为什么规定这些步骤、哪些条件不可省略，以及结果偏离时应回到哪一层检查。
使用判断：先确认任务与原文边界一致，再决定是否启用；来源没有说明的命令、平台和依赖保持未知，不由 Fluxly 补写。

边界和复核

依赖条件：通常不需要额外 API Key，适合先用小任务验证触发是否稳定。
权限提醒：会涉及 read / write / shell-exec / env-read 权限，执行前要说明可读写范围、命令边界和回退方式。
质量标准：结果应包含明确产物、必要证据和下一步动作；如果只是泛泛解释，需要补充输入和验收条件后重跑。

PyMAPDL CLI

The pymapdl CLI lets you manage MAPDL instances and execute APDL commands directly from the terminal. It is installed automatically with the ansys-mapdl-core Python package and requires the click dependency (included by default).

A typical session looks like this:

pymapdl start                          # launch a solver instance
pymapdl exec -c /prep7 -c "K,1,0,0,0" # send commands to it
pymapdl exec --file model.inp          # or send a whole script
pymapdl stop                           # shut it down

All commands print human-readable output to stdout and errors to stderr. Exit code is 0 on success, 1 on failure.

Commands at a glance

Command	Purpose
`pymapdl start`	Launch a new local MAPDL instance
`pymapdl stop`	Kill one or all running instances
`pymapdl list`	Show running MAPDL processes
`pymapdl exec`	Send APDL commands to a running instance
`pymapdl convert`	Translate an APDL script to Python

`pymapdl start`

Launch a new MAPDL gRPC server. Prints the IP, port, and PID on success.

pymapdl start [OPTIONS]

Key options

Option	Default	Description
`--port`	50052 (or `PYMAPDL_PORT`)	gRPC port; first available port at or after this value
`--exec_file`	auto-detected	Path to the MAPDL executable
`--run_location`	temp dir	Working directory for the MAPDL process
`--jobname`	`file`	MAPDL jobname
`--nproc`	2	Number of processors
`--ram`	all available	Fixed memory in MB
`--override`	off	Delete stale lock files before starting
`--additional_switches`	none	Extra MAPDL command-line switches (e.g. `aa_r` for academic license)
`--start_timeout`	45	Seconds to wait for the server to become ready
`--license_type`	none	License name (e.g. `meba`, `ansys`) or description (e.g. `enterprise`)
`--version`	latest	MAPDL version to launch (e.g. `241`, `24.1`)

Example — start on a custom port with 4 CPUs:

pymapdl start --port 50055 --nproc 4
# Success: Launched an MAPDL instance (PID=12345) at 127.0.0.1:50055

`pymapdl stop`

Stop running MAPDL instances. By default targets port 50052.

pymapdl stop [OPTIONS]

Options

Option	Description
`--port PORT`	Stop instances listening on this port
`--pid PID`	Stop the process (and its children) with this PID
`--all`	Stop every MAPDL instance on the machine

Examples:

pymapdl stop                  # stop instance on default port 50052
pymapdl stop --port 50055     # stop instance on port 50055
pymapdl stop --pid 12345      # stop a specific process tree
pymapdl stop --all            # stop all MAPDL processes

`pymapdl list`

List MAPDL processes currently running on the machine.

pymapdl list [OPTIONS]

Options

Option	Short	Description
`--instances`	`-i`	Show only parent instances (hide child processes)
`--long`	`-l`	Show all columns (command line + working directory)
`--cmd`	`-c`	Include the command-line column
`--location`	`-cwd`	Include the working-directory column

Example:

pymapdl list -i
# Name          Status    gRPC port    PID
# ANSYS241.exe  running       50052  41644

`pymapdl exec`

Send APDL commands to an already running MAPDL instance and print the solver output. This command never starts a new instance — use pymapdl start first.

pymapdl exec [OPTIONS] [-]

Three input modes (mutually exclusive)

Repeated -c / --command (recommended for scripting and LLM use):
```
pymapdl exec -c /prep7 -c "BLOCK,0,1,0,1,0,1" -c SAVE
```
Each -c value is one APDL command. They are joined with newlines and sent as a single input_strings() block for maximum performance.
File with --file / -f:
```
pymapdl exec --file model.inp
```

Stdin by passing - as a positional argument:

# Linux / macOS
cat model.inp | pymapdl exec -

# Windows PowerShell
Get-Content model.inp | pymapdl exec -

Options

Option	Short	Default	Description
`--command`	`-c`	—	APDL command (repeatable)
`--file`	`-f`	—	Path to an APDL script file
`--port`	—	50052 (or `PYMAPDL_PORT`)	gRPC port of the target instance
`--ip`	—	127.0.0.1 (or `PYMAPDL_IP`)	IP of the target instance
`--timeout`	—	10	Connection timeout in seconds
`--clear-on-connect`	—	off	Clear MAPDL database before sending commands

Behavior notes

Successive calls share state. Because --clear-on-connect is off by default, you can split a workflow across multiple pymapdl exec invocations and the model/mesh/results persist between them.
Output goes to stdout, errors to stderr — ideal for piping, logging, or LLM consumption.
Windows paths are safe. Backslash sequences like C:\new\file are preserved verbatim; no mangling occurs.

`pymapdl convert`

Convert an APDL script to a PyMAPDL Python script.

pymapdl convert [OPTIONS]

Key options

Option	Short	Default	Description
`--file`	`-f`	stdin	APDL input file
`--output`	`-o`	stdout	Output Python file
`--macros_as_functions`	`-mf`	True	Convert macros to Python functions
`--use_function_names`	`-fn`	True	Use method names (`mapdl.k`) instead of `mapdl.run('K')`
`--only_commands`	`-oc`	off	Emit only MAPDL calls (no imports/header/exit)
`--add_imports`	`-ai`	True	Add `launch_mapdl()` boilerplate
`--comment_solve`	`-cs`	off	Comment out SOLVE / /EOF lines

Example:

pymapdl convert -f model.inp -o model.py

Environment variables

Variable	Used by	Purpose
`PYMAPDL_PORT`	`start`, `exec`	Default gRPC port when `--port` is omitted
`PYMAPDL_IP`	`exec`	Default IP when `--ip` is omitted
`PYMAPDL_MAPDL_EXEC`	`start`	Path to MAPDL executable

Common workflows

Interactive modeling session

pymapdl start --port 50055
pymapdl exec --port 50055 -c /prep7
pymapdl exec --port 50055 -c "ET,1,186" -c "BLOCK,0,1,0,1,0,1" -c "VMESH,ALL"
pymapdl exec --port 50055 --file boundary_conditions.inp
pymapdl exec --port 50055 -c /solu -c SOLVE
pymapdl stop --port 50055

Run a full script in one shot

pymapdl start
pymapdl exec --file full_model.inp
pymapdl stop

Pipe commands from another tool

# Generate APDL dynamically and pipe it in
python generate_mesh.py | pymapdl exec -

Fresh database each time

pymapdl exec --clear-on-connect -c /prep7 -c "K,1,0,0,0"

安装命令

一键复制安装选择包管理器,点击右侧复制,粘贴到终端回车即可

npx skills add ansys/pymapdl/src/ansys/mapdl/core/skills/pymapdl-cli -y

查看通用安装教程

查看 Skill 原文

兼容工具

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

安全审计

88 / 100

社区

未声明 license/许可。
未声明 version。
未限定 allowed-tools，默认拥有全部工具权限。

元信息

来源: github
ansys/pymapdl
English

分类与标签

分类写作

先判断是否适合

作者设计意图

作者的方法与取舍

边界和复核

PyMAPDL CLI

Commands at a glance

pymapdl start

Key options

pymapdl stop

Options

pymapdl list

Options

pymapdl exec

Three input modes (mutually exclusive)

Options

Behavior notes

pymapdl convert

Key options

Environment variables

Common workflows

Interactive modeling session

Run a full script in one shot

Pipe commands from another tool

Fresh database each time

讨论

`pymapdl start`

`pymapdl stop`

`pymapdl list`

`pymapdl exec`

`pymapdl convert`