Formax Script Output Placement Workflow

Name: Formax Script Output Placement Workflow
Author: yusifeng

ASecurity

Use when adding or modifying generator scripts that write files; keeps generated artifacts out of docs/ and aligns script defaults with ownership paths plus CI gate updates.

192 stars
0 votes
0 copies
2 views
Added May 26, 2026

data-aigonodegit

Security analysis

A100/100

Scanned May 27, 2026

npx -y skills add yusifeng/formax --skill formax-script-output-placement-workflow --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Formax Script Output Placement Workflow?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Formax Script Output Placement Workflow

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/yusifeng-formax-script-output-placement-workflow/badge)](https://www.skillsdirectory.com/skills/yusifeng-formax-script-output-placement-workflow)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: formax-script-output-placement-workflow
description: Use when adding or modifying generator scripts that write files; keeps generated artifacts out of docs/ and aligns script defaults with ownership paths plus CI gate updates.
---

# Formax Script Output Placement

## Goal

新增或修改“会写文件”的脚本时，避免把机器产物放到 `docs/`。

## Placement Rules

1. `docs/` 只放文档与静态说明素材，不放机器生成基线/报告。
2. 产物就近放到 owner 目录：
   - app 产物 -> `apps/<name>/perf/`
   - repo 级脚本产物 -> `scripts/baselines/`
   - 临时产物 -> `.tmp/`（gitignored）
3. 生成脚本默认输出路径应指向 owner 目录，不指向 `docs/**`。
4. 建议提供 `--output` 或 `--baseline` 覆盖参数（便于 CI 与本地临时切换路径）。

## Minimal Workflow

1. 先定产物 owner 与默认输出目录。
2. 再写脚本和默认路径（owner-local）。
3. 同步更新 README/learning 里的路径引用。

## Checks

- `node ./scripts/check-docs-artifact-placement.mjs`