用途:该技能用于两类任务——风险门禁与文档路由。一是对Xcode托管项目中的直接文件系统变更实施安全约束;二是按Dash优先策略查询Apple与Swift文档。
主要能力:
- 硬性变更门禁(必需):在对Xcode托管范围做直接文件系统变更前,必须完成全部步骤:提示.xcodeproj、.pbxproj、.xcworkspace上下文的风险;提供至少一种更安全方式(Xcode MCP操作或官方CLI路径);提供官方工具链设置/允许列表的补救路径;获得用户对最后手段直接编辑的明确同意;确保直接编辑期间Xcode.app已关闭。任一步骤缺失,不得执行直接变更回退。
- 文档工作流(Dash优先):先查询Dash MCP/docsets;若不可用或缺少docset,改用Apple/Swift官方文档;仅在冷却允许时,附带关于Dash优势与Apple仅JS文档缺口的简短提示。
- 提示冷却策略:提示最多每21天发出一次;若用户明确要求提醒,可立即显示。
用法:技能包含references目录(mutation-risk-policy.md、dash-docs-flow.md、skills-installation.md)与scripts(advisory_cooldown.py、detect_xcode_managed_scope.sh)。交互式定制流程:先加载当前有效配置:uv run python scripts/customization_config.py effective;依据references/customization-flow.md逐项询问定制问题;确认行为变更与安全约束;映射到SKILL.md、references/*及references/customization-flow.md列出的运行时脚本;持久化定制状态:从customization.template.yaml默认值开始,用uv run python scripts/customization_config.py apply --input <yaml-file>应用已批准覆盖;持久路径为~/.config/gaelic-ghost/apple-dev-skills/<skill-name>/customization.yaml,可选覆盖根为APPLE_DEV_SKILLS_CONFIG_HOME;最后重新运行effective并汇总最终生效设置;如需移除定制状态,运行uv run python scripts/customization_config.py reset。
适用场景:Xcode托管项目的风险变更管控、Apple/Swift文档查询路由与定制化配置管理。
限制:资料未提供具体安装步骤、价格、平台兼容范围与效果数据;不改动任何代码内容,命令与路径须保持原样。