AgentSkillsCN

manipulate-xcodeproj

仅使用XcodeProjectCLI（xcp）操作Xcode项目与资源目录。适用于编辑.xcodeproj/.pbxproj文件，添加/移动/重命名/删除组或文件，更改目标成员关系，读取或设置构建配置，或管理xcassets资源的场景。

SKILL.md
--- frontmatter
name: manipulate-xcodeproj
description: Manipulate Xcode projects and asset catalogs using XcodeProjectCLI (xcp) only. Use when editing .xcodeproj/.pbxproj files, adding/moving/renaming/deleting groups or files, changing target membership, reading or setting build settings, or managing xcassets assets.

Manipulate Xcodeproj

Overview

Use xcp for all project edits and asset catalog operations. Install it with brew install xcp if it is not already available.

Workflow

  1. •Identify the .xcodeproj or .xcassets path.
  2. •For target-specific actions, run xcp list-targets first.
  3. •Run the appropriate xcp subcommand. Use --project-only to update the project file without touching the filesystem.
  4. •Re-run xcp list-targets or xcp list-assets if you need to verify results.

Tasks

Project structure

Use group and file subcommands to add, move, rename, or delete entries. Use --create-groups when adding and --guess-target when you want the tool to infer targets for a new file.

Targets and build settings

Use list-targets to discover names, set-target to update file memberships, and build-setting commands to read or update configuration values.

Asset catalogs

Operate on .xcassets directories directly for image, data, and color assets. Paths are relative to the .xcassets root.

References

  • •Command and flag reference: references/xcp-cli.md
  • •For flags and usage specifics, prefer xcp help <subcommand> as the source of truth.