Skip to content
cccskills
FreePublished on GitHub

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when a Formax repository task is non-trivial and you should analyze goals, non-goals, boundaries, data/type/interface impact, contract impact, test strategy, and whether an xhigh subagent is actually needed before writing a todo or code.

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

Use when adding or changing any Approval prompt/presenter.

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

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

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

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.

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

Use when implementing/debugging Ctrl+O Expanded Transcript (second view) and thinking persistence in the REPL.

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

Use when implementing or debugging Formax permissions/policy/approval behavior and UI (allow/ask/deny rules, workspace boundaries, approval prompts, and /permissions overlay parity with Claude Code).

The English summary is being prepared. Showing the original description.

yusifeng/formax194Updated Jul 25, 2026

See all skills by yusifeng

Report a problem with this skill