Agent skill

formax-script-output-placement-workflow

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.

Stars 138
Forks 7

Install this agent skill to your Project

npx add-skill https://github.com/yusifeng/formax/tree/main/.codex/skills/formax-script-output-placement-workflow

SKILL.md

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

Expand your agent's capabilities with these related and highly-rated skills.

yusifeng/formax

formax-dev-loop-workflow

Use when working on Formax code changes and you need a disciplined dev loop: keep a single mainline task, avoid scope drift, run only targeted tests (no coverage), avoid partial staging (MM), run mandatory review before commit, include an incremental optimization check, and keep commits small and reviewable.

138 7
Explore
yusifeng/formax

formax-rework-convergence-workflow

Use when code has gone through repeated rework and may contain redundant logic, style drift, or tangled structure. Trigger when user asks for "返工收敛", "cleanup-pass", or requests a focused cleanup pass that reduces churn without changing behavior.

138 7
Explore
yusifeng/formax

formax-tool-ui-blocks-workflow

Implement or refactor Formax tool transcript UI using the Tool UI Blocks (C-lite) pattern (ToolUiBlocks renderer + blocks presenters) to avoid touching many tool presenter files; use when adjusting ⏺/⎿ spacing, indent rules, or migrating additional tools to blocks presenters with targeted Ink/Vitest tests and Codex review before commit.

138 7
Explore
yusifeng/formax

formax-web-css-convergence-workflow

Use when changing web CSS/UI styling so requirements, state ownership, and acceptance checks are locked before edits to prevent rework churn.

138 7
Explore
yusifeng/formax

formax-config-settings-workflow

Use when implementing or extending /config (storage, prompt injection, request params, UI-only toggles) with tests and strict UI parity.

138 7
Explore
yusifeng/formax

formax-semantics-parity-workflow

Use when implementing or modifying behavior that must stay consistent across TUI and Web (mode/input/tool/replay/order). Require canonical semantics first, then TUI/Web adapters, then renderer-specific UI.

138 7
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results