AgentSkillsCN

apply-artifacts

在严格验证路径并采用原子写入方式的情况下，安全地解析并把规划输出中的 `## ARTIFACTS` 块应用到仓库文件中。当工作流响应包含必须原样写入的工件负载（例如 PRD、PSD、主计划、功能计划、PR 计划或变更评审输出）时，可使用此功能。

SKILL.md
--- frontmatter
name: apply-artifacts
description: Safely parse and apply `## ARTIFACTS` blocks from planning outputs into repository files with strict path validation and atomic writes. Use when a workflow response contains artifact payloads (for PRD/PSD/master plan/feature plan/PR plan/change-review outputs) that must be written exactly as provided.

Apply Artifacts

Apply planning artifacts deterministically and report exactly what changed.

Workflow

  1. •Confirm input contains an ## ARTIFACTS section with one or more ### <relative/path> headers.
  2. •Save the full planning output to a temporary input file.
  3. •Run scripts/apply_artifacts.py against the target repository root.
  4. •Return the script report verbatim.
  5. •If validation fails, stop and ask for corrected artifacts.

Run

bash
python3 "$HOME/.codex/skills/apply-artifacts/scripts/apply_artifacts.py" \
  --input /tmp/artifacts-input.md \
  --root /path/to/repo

Use --check to validate without writing files.

Rules

  • •Write only files listed under ## ARTIFACTS.
  • •Require relative paths only.
  • •Reject path traversal (../, ..\\), home shortcuts (~/), absolute paths, URL-like paths, and duplicate artifact targets.
  • •Create parent directories when needed.
  • •Replace file contents atomically.
  • •Do not rewrite or "improve" artifact content.

Output

Expect Markdown sections:

  • •Applied Artifacts
  • •Directories Created
  • •Warnings
  • •Notes

References

  • •Artifact format and edge-case guidance: references/artifact-format.md