Agent Skills
› harumiWeb/exstruct
› exstruct-cli
exstruct-cli
GitHub指导Agent使用ExStruct CLI安全处理Excel工作簿的创建、编辑与验证。涵盖命令选择、安全规则及干跑流程,适用于新建、修改或校验场景,复杂任务移交MCP。
Trigger Scenarios
需要创建新的Excel工作簿
需要编辑现有Excel文件
不确定文件可读性或需验证格式
查询操作列表或具体约束
涉及Excel处理的决策咨询
Install
npx skills add harumiWeb/exstruct --skill exstruct-cli -g -y
SKILL.md
Frontmatter
{
"name": "exstruct-cli",
"description": "Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely. Trigger when an agent needs `exstruct patch`, `exstruct make`, `exstruct validate`, `exstruct ops list`, or `exstruct ops describe`, especially for create-vs-edit decisions, dry-run workflows, backend constraints, or safe workbook-edit guidance."
}
ExStruct CLI
Use the existing editing CLI as the default local operational interface for ExStruct workbook create/edit requests.
Select a command
- Use
exstruct makewhen the user wants a new workbook created and populated. - Use
exstruct patchwhen the user wants an existing workbook edited. - Use
exstruct validatewhen workbook readability is uncertain or before a risky edit on an unfamiliar file. - Use
exstruct ops listwhen the required operation is still unclear. - Use
exstruct ops describe <op>when you know the likely op name but need the exact schema or constraints. - Hand the workflow off to MCP when the user needs host-owned path policy, transport mapping, artifact mirroring, or other server-managed behavior.
Safety rules
- Do not invent unsupported patch ops.
- Do not apply destructive edits immediately when the request is ambiguous.
- Prefer
--dry-runbefore risky edits. - Pin
--backend openpyxlwhen the dry run and the real apply must use the same engine. - Explain backend-specific failures directly instead of hiding them behind a generic retry.
Workflow
- Decide whether the request is create, edit, or actually an MCP-hosted task.
- Identify the needed op or inspect the public op schema.
- Validate the workbook when the file, backend, or request is uncertain.
- Run
--dry-runfor risky edits and inspectPatchResult. - Apply the real edit only after the planned change is acceptable.
- Verify the result with the lightest step that still matches the user's risk.
References
references/command-selection.mdreferences/safe-editing.mdreferences/ops-guidance.mdreferences/verify-workflows.mdreferences/backend-constraints.md
Version History
- 92bc120 Current 2026-07-05 14:54


