AgentSkillsCN

ios-kit

为 iOS 项目制定启动运行手册,明确技术栈决策、搭建项目骨架、配置 GitHub 安全策略,并确认各项治理约束。

SKILL.md
--- frontmatter
name: ios-kit
description: Startup runbook for iOS projects. Establishes stack decisions, scaffolds the project, configures GitHub security, and confirms governing constraints.
disable-model-invocation: true

Purpose

Initialize a new iOS project with the standard stack, scaffolding, GitHub security, and constraints.

Input: <app-name> (optional, default: "App")

Startup sequence (execute in order)

1. Confirm stack decisions

Execute /ios-stack to establish platform choices, architecture, environment model, and quality posture.

2. Scaffold the project

Execute /ios-scaffold <app-name> [--github] to create a buildable baseline with offline-first storage, push plumbing (stubbed), tooling, and CI.

Verify the scaffold passes all quality gates before proceeding (build, tests, lint, format).

3. Set up local Git hooks

Execute /github-hooks --platform ios to install Git hooks for pre-commit validation (SwiftLint, SwiftFormat, secrets), commit message enforcement, and pre-push tests.

4. Configure GitHub security (if --github was used)

Execute /github-secure to apply branch protection, Dependabot, CodeQL (Swift), CODEOWNERS, SECURITY.md, PR templates, and security workflows.

5. Verify constraints are active

Confirm these always-on skills are enabled:

  • ios-sec — security policy
  • ios-nfr — non-functional requirements
  • ios-std — coding standards
  • ios-styleguide — design/UX standards

Quality workflows (invoke as needed)

  • /ios-unit-test — run tests, report failures, fix with approval
  • /ios-code-review — review against policies, fix with approval
  • /ios-design-review — visual review of screens, fix with approval

Additional workflows (invoke as needed)

  • /ios-add-feature — scaffold new features
  • /ios-add-auth — add authentication
  • /ios-deps — dependency management
  • /ios-release — App Store release preparation
  • /ios-teardown — tear down project (reverse of /ios-kit)

Ready state

After completing the startup sequence, the project is ready to develop when ALL of these pass:

  • xcodebuild build succeeds with zero warnings
  • xcodebuild test passes all tests
  • ./scripts/lint.sh reports zero violations
  • ./scripts/format.sh makes no changes
  • Git hooks are installed and functional (pre-commit, commit-msg, pre-push)
  • CI passes on first push (if --github)

If any gate fails, fix before proceeding to feature development.

Output

After running this kit, confirm:

  • Stack decisions applied
  • Project scaffolded and building
  • Local Git hooks installed (pre-commit, commit-msg, pre-push)
  • GitHub security configured (if --github)
  • Governing constraints active
  • Quality workflows available
  • Ready state achieved (all gates passing)