{"id":"cf422c1e-e7cf-4abe-88d8-6651c869f9d1","entityType":"agent","slug":"clawhub-iluoyao-mac-check-skill","name":"MacCheck","canonicalUrl":"https://www.xpersona.co/agent/clawhub-iluoyao-mac-check-skill","canonicalPath":"/agent/clawhub-iluoyao-mac-check-skill","generatedAt":"2026-10-10T08:45:29.663Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T04:04:22.813Z","emptyReason":null},"description":"An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report. Skill: MacCheck Owner: iluoyao Summary: An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:22:13.694Z | auto Initial release of mac-check-skill. - Launches a full, local hardware and system check for Mac devices, covering dev","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s177w5h70hgnd1y6bqhat70s698caga7:mac-check-skill","sourceUrl":"https://clawhub.ai/iluoyao/mac-check-skill","homepage":"https://clawhub.ai/iluoyao/skills/mac-check-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/iluoyao/mac-check-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/iluoyao/skills/mac-check-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":65,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downl"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:04:22.813Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:04:22.813Z","emptyReason":null},"stars":null,"forks":null,"downloads":1704,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T04:04:22.785Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T04:04:22.813Z","lastCrawledAt":"2026-10-10T04:04:22.785Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T04:04:22.785Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-12T07:22:13.694Z","changelog":"Initial release of mac-check-skill. - Launches a full, local hardware and system check for Mac devices, covering device, system, battery, security, storage, network, and built-in peripheral tests. - Operates strictly read-only, offline, and without requiring administrator privileges; never uploads data or connects to the internet. - Generates detection reports in MD, PDF, and PNG formats for download. - Designed for use cases including routine health checks, device acceptance, post-repair verification, pre-sale inspection, and troubleshooting. - Offers both integrated Agent desktop host operation and terminal-based execution, with clear instructions for each. - Ensures no system changes, no unofficial guarantees, and clear separation from Apple official diagnostics.","fileCount":47,"zipByteSize":76929}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177w5h70hgnd1y6bqhat70s698caga7:mac-check-skill","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T08:45:29.662Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T04:04:22.813Z","emptyReason":null},"readme":"Skill: MacCheck\n\nOwner: iluoyao\n\nSummary: An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report.\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-12T07:22:13.694Z | auto\n\nInitial release of mac-check-skill.\n\n- Launches a full, local hardware and system check for Mac devices, covering device, system, battery, security, storage, network, and built-in peripheral tests.\n- Operates strictly read-only, offline, and without requiring administrator privileges; never uploads data or connects to the internet.\n- Generates detection reports in MD, PDF, and PNG formats for download.\n- Designed for use cases including routine health checks, device acceptance, post-repair verification, pre-sale inspection, and troubleshooting.\n- Offers both integrated Agent desktop host operation and terminal-based execution, with clear instructions for each.\n- Ensures no system changes, no unofficial guarantees, and clear separation from Apple official diagnostics.\n\nArchive index:\n\nArchive v0.1.0: 47 files, 76929 bytes\n\nFiles: agents (0b), agents/openai.yaml (288b), assets (0b), assets/data (0b), assets/data/checks.json (855b), assets/data/device-capabilities.json (14482b), assets/data/keyboard-layouts.json (2733b), assets/i18n (0b), assets/i18n/en-US.json (21610b), assets/i18n/zh-CN.json (21095b), assets/session-template.html (703b), assets/session.css (21655b), assets/session.js (58204b), README.en.md (2454b), README.md (2338b), references (0b), references/agent-runtime.md (1079b), references/architecture.md (1892b), references/detection-catalog.md (1092b), references/privacy.md (888b), references/report-spec.md (1149b), references/rule-spec.md (1176b), references/test-matrix.md (1698b), schemas (0b), schemas/facts.schema.json (6512b), schemas/report.schema.json (950b), schemas/result.schema.json (2639b), schemas/session.schema.json (2030b), scripts (0b), scripts/build-session.jxa (5397b), scripts/build-session.sh (184b), scripts/collect-system.sh (1945b), scripts/evaluate-system.jxa (6459b), scripts/evaluate-system.sh (113b), scripts/helpers (0b), scripts/helpers/safe-command.sh (1542b), scripts/helpers/wifi-power.sh (641b), scripts/normalize.jxa (15908b), scripts/normalize.sh (107b), scripts/open-session.sh (117b), scripts/prepare-session.jxa (1594b), scripts/prepare-session.sh (113b), scripts/run-full-check.sh (1775b), scripts/runtime-check.sh (806b), skill-card.md (2240b), SKILL.md (5354b), _meta.json (134b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: mac-check-skill\ndescription: 用于 Mac 验机。在当前 Mac 上进行一次完整的本地检测任务，可检测设备、系统、电池、安全、存储、网络等系统信息，以及内置页面工具可检测键盘、屏幕、声音、麦克风、摄像头、触控板和接口等信息。权限只读、数据本地、不联网，检测结果支持下载为 MD、PDF、PNG 报告。适用于 Mac 日常健康检查、新机或整备机验收、维修后复检、购买或出售前检查及故障排查。检测结果仅反映可观察到的状态，不构成 Apple 官方诊断、质量保证或交易承诺。\nversion: 2.0.1\nauthor: Eddy\n---\n\n# Mac 验机助手\n\n为用户启动一次完整、只读、默认离线的 Mac 检测。自动检测完成后，以本地 Session App 作为唯一操作界面；用户可在页面完成硬件检查、查看结论并直接下载报告。\n\n## 使用边界\n\n- 用户表达“验机”“Mac检测”“全面检查”“设备体检”“收货/维修验收”“购买或出售前检查”等完整检查意图时使用。\n- 当前版本固定创建完整 Session；若用户只想了解某个单项，应直接回答或说明该项能力，不要悄悄启动整套流程。\n- 支持能够在目标 Mac 上运行本地脚本并打开本地 HTML 的兼容 Agent 桌面宿主，不依赖特定产品、回调协议或对话持续运行。\n- 根据当前对话选择 `zh-CN` 或 `en-US`；无法判断时使用 `zh-CN`。\n\n## 无 Agent 终端运行\n\n本项目也可以在没有 Agent 桌面端的情况下直接运行。下载或解压项目后，用户可打开“终端”，进入项目根目录并执行：\n\n```bash\ncd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN\n```\n\n英文界面将 `zh-CN` 改为 `en-US`。系统检测完成后会自动打开本地硬件检测页面；如果页面未能自动打开，可使用终端输出中的 `SESSION_HTML` 路径手动打开。此方式与 Skill 执行流程复用同一入口，不需要 `chmod`、`sudo`、清除隔离属性或安装额外依赖。\n\n当 Agent 正在执行验机任务时，仍按下方“执行流程”直接调用入口，不要额外要求用户改用终端；仅在用户询问无 Agent 使用方法时提供上述说明。\n\n## 执行流程\n\n1. 简短告知用户：将运行只读系统检测，不使用管理员权限、不修改系统设置；默认不联网，也不上传序列号或结果。\n2. 用户同意后，读取 [architecture.md](references/architecture.md)、[privacy.md](references/privacy.md) 和 [agent-runtime.md](references/agent-runtime.md)。\n3. 必须显式使用 zsh 执行入口；不要依赖压缩包保留可执行权限，也不要要求用户 `chmod`：\n\n```bash\n/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale \n```\n\n4. 入口依次执行环境检查、Session 创建、系统采集、事实规范化、确定性规则判断、单文件 Session App 构建与打开。\n5. 成功后只需说明：系统自动检测已完成，检查页面已经打开；请用户在页面继续硬件检测并下载报告。\n6. 若系统不允许自动打开页面，向用户提供脚本输出的 `SESSION_HTML` 绝对路径。不要等待或要求用户把结果复制回聊天。\n\n测试或用户明确不希望打开页面时：\n\n```bash\n/bin/zsh scripts/run-full-check.sh --output-root --locale --no-open\n```\n\n## 正确性与安全\n\n- 只运行 [detection-catalog.md](references/detection-catalog.md) 中的只读命令；不使用 `sudo`、下载脚本、绕过锁定或修改系统的命令。\n- Collector 只记录事实；Normalizer 只规范化；只有 [rule-spec.md](references/rule-spec.md) 的确定性规则可以生成结论。读取失败必须标为 `UNKNOWN`，不能伪装成通过。\n- Session App 不执行 Shell、不读取相邻文件、不依赖 CDN、localhost、MCP、AI 回调或外部服务。Apple 保修入口只能由用户主动点击，页面不能后台提交序列号。\n- 浏览器无法可靠观察的 Touch ID、物理接口、Force Touch 和感官质量必须采用清晰的引导验证，不得冒充自动检测。\n- 不生成缺乏依据的综合评分，不写“放心购买”，不声称 Apple 官方检测或保证不存在任何管理与锁定风险。\n- 系统数据必须序列化和转义后注入 HTML。完整序列号只保存在本地 Session 与报告中，页面不得把它发往网络；用户主动前往 Apple 官网查询保修时自行决定是否提交。\n\n## 页面与报告\n\n- 状态以页面当前内存为准，`localStorage` 仅作尽力恢复；页面不写回 `session.json`。\n- 报告遵循 [report-spec.md](references/report-spec.md)。在线风险查询、支付、性能测试、硬盘测速和 AI 评估不属于当前阶段，相关 feature flag 保持关闭。\n\n## 失败处理\n\n- 单项命令失败：继续其他检测，将对应结果标为“无法读取/需要确认”。\n- 设备身份完全无法读取：停止构建页面，保留诊断文件并说明原因。\n- 页面构建失败：保留 `facts.json` 与 `system-results.json`，不要由 AI 临时拼接替代页面或报告。\n- 麦克风或摄像头权限失败：页面标为“无法确认”并允许重试，不能直接判断硬件损坏。\n\nFile v0.1.0:README.md\n\n# MacCheck Skill\n\n[简体中文](README.md) | [English](README.en.md)\n\n一款用于 Mac 检查的 Agent Skill。运行后会自动检测系统与设备信息，并打开本地页面，引导你完成键盘、屏幕、声音等硬件检查，最后生成可下载的验机报告。\n\n## 能做什么\n\n- 自动检查机型、系统、电池、存储、安全状态、网络和外设等信息。\n- 引导检查键盘、屏幕、声音、麦克风、摄像头、Touch ID、触控板和接口。\n- 自动识别不同 Mac 机型的硬件能力，并为未知新机型提供安全回退。\n- 下载 Markdown、PDF 或 PNG 格式的验机报告。\n- 支持简体中文和英文。\n\n## 使用方法\n\n下载或克隆本仓库，或在 Releases 中下载 `mac-check-skill.zip` 并解压，然后选择以下任一方式启动。\n\n### 通过 Agent 使用\n\n1. 在你使用的 Agent 桌面端（例如 WorkBuddy、Claude、Codex、Cursor 等），将本仓库作为 Skill 安装或导入。\n2. 对 AI 说：\n\n > 帮我检查这台 Mac。\n\nAI 会创建本次验机任务、自动完成系统检测，并打开硬件检测页面。按照页面引导完成检查后，即可直接下载报告。\n\n### 通过终端使用\n\n不使用 Agent 时，打开“终端”，进入解压后的项目根目录并运行：\n\n```bash\ncd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN\n```\n\n请将 `/path/to/mac-check-skill` 替换为实际项目路径。系统检测完成后会自动打开本地硬件检测页面；如果未能自动打开，请在终端输出中找到 `SESSION_HTML` 路径并手动打开。检测数据保存在项目根目录的 `mac-check-output` 中。\n\n## 隐私说明\n\n- 默认在本机离线运行，不主动上传检测数据。\n- 系统检测均为只读操作，不会修改系统设置。\n- 检测结果与报告保存在本地；公开分享前请留意序列号等设备信息。\n\n## 使用提示\n\n受浏览器和 macOS 权限限制，Touch ID、屏幕坏点、声音质量、触控板手感和接口物理状态等项目仍需用户配合确认。检测结果仅供参考，不替代 Apple 官方诊断。\n\n## 致谢\n\n本项目的部分产品思路与设计灵感来源于 [MacCheck](https://github.com/andyhuo520/MacCheck)，感谢原作者及贡献者的优秀工作。\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn77991za3nvfyfaq0fcgre66s8ca9xh\",\n \"slug\": \"mac-check-skill\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1786519333694\n}\n\nFile v0.1.0:references/agent-runtime.md\n\n# Agent 桌面运行环境\n\nP0 将真实 `Darwin` 主机视为可检查环境。运行 `scripts/runtime-check.sh `，验证 `/usr/sbin/system_profiler`、`/usr/bin/osascript`、`/usr/bin/open` 等本地能力是否存在。\n\n兼容宿主可能从压缩包、缓存目录或沙箱工作区安装 Skill，因此不能假设文件保留 Unix 可执行位。所有对项目内 shell 文件的调用都必须显式使用 `/bin/zsh ` 时不能逃逸数据块。\n\n## 页面\n\n- 单文件、无 CDN、无 `fetch`、无 Result Token、`connect-src 'none'`。\n- Sidebar/Overview、6 个基础页面、8 个硬件页面、Guided Flow、重测。\n- 键盘事件、屏幕全屏、音频、媒体权限拒绝、Touch ID 引导、触控板、接口跳过。\n- `localStorage` 可用/不可用、刷新恢复、Markdown/PDF/PNG 直接下载。\n- 960×680、1440×900、浅色/深色和 reduced motion。\n\n## 真机\n\n兼容 Agent 桌面宿主至少验证一次：完整检查触发 → 权限 → 采集 → 自动打开 → 完成硬件 → 下载 Markdown/PDF/PNG。打包后脚本即使没有可执行位也必须可以通过显式 zsh 正常运行。自动测试不能替代实际声画、Touch ID、接口和不同机型能力验证。\n\nFile v0.1.0:README.en.md\n\n# MacCheck Skill\n\n[简体中文](README.md) | [English](README.en.md)\n\nAn Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report.\n\n## What It Checks\n\n- Mac model, system, battery, storage, security status, network, and peripherals.\n- Keyboard, display, audio, microphone, camera, Touch ID, trackpad, and ports.\n- Hardware capabilities matched to different Mac models, with safe fallback behavior for unknown new models.\n- Downloadable reports in Markdown, PDF, or PNG.\n- Simplified Chinese and English interfaces.\n\n## How to Use\n\nDownload or clone this repo, or download and extract `mac-check-skill.zip` from Releases, then choose either method below.\n\n### Use with an Agent\n\n1. In your Agent desktop (e.g., WorkBuddy, Claude, Codex, Cursor), install or import this repo as a Skill.\n2. Ask the AI:\n\n > Check this Mac for me.\n\nThe AI creates an inspection Session, runs the system checks, and opens the hardware-check page. Follow the on-screen guidance, then download the completed report directly from the page.\n\n### Use from Terminal\n\nTo run MacCheck without an Agent, open Terminal, enter the extracted project root, and run:\n\n```bash\ncd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale en-US\n```\n\nReplace `/path/to/mac-check-skill` with the actual project path. When the system checks finish, the local hardware-check page opens automatically. If it does not open, find the `SESSION_HTML` path in Terminal and open it manually. Inspection data is saved in `mac-check-output` at the project root.\n\n## Privacy\n\n- Runs locally and offline by default. Inspection data is not uploaded automatically.\n- System checks are read-only and do not modify system settings.\n- Results and reports stay on the Mac. Review device details such as the serial number before sharing a report publicly.\n\n## Notes\n\nDue to browser and macOS permission limits, checks such as Touch ID, display defects, audio quality, trackpad feel, and the physical condition of ports still require user confirmation. Results are for reference and do not replace an official Apple diagnostic.\n\n## Acknowledgements\n\nSome product ideas and design inspiration for this project came from [MacCheck](https://github.com/andyhuo520/MacCheck). Many thanks to its author and contributors for their excellent work.\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nMacCheck inspects local Mac system and device information, opens a local guided hardware-check page, and generates downloadable inspection reports.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[iluoyao](https://clawhub.ai/user/iluoyao)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and support agents use MacCheck to perform read-only local Mac health, acceptance, repair follow-up, resale, or troubleshooting checks. It combines automated system inventory with guided hardware confirmation and local report export.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Local reports can contain detailed system inventory, serial number, and device details.\n\nMitigation: Keep the output directory private, review exported reports before sharing, and delete saved reports when they are no longer needed.\n\nRisk: Inspection results are local observations and may not prove future server-side lock, enrollment, warranty, or repair-history status.\n\nMitigation: Treat the report as a local health-check aid and verify purchase, warranty, or management status through official channels before relying on it for a transaction.\n\n## Reference(s):\n\n- [Server-resolved GitHub source](https://github.com/iluoyao/mac-check-skill)\n- [ClawHub skill page](https://clawhub.ai/iluoyao/skills/mac-check-skill)\n- [Privacy](references/privacy.md)\n- [Architecture](references/architecture.md)\n- [Detection catalog](references/detection-catalog.md)\n- [Report specification](references/report-spec.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, files, guidance]\n\n**Output Format:** [Local HTML session plus downloadable Markdown, PDF, and PNG reports]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Runs locally by default and saves inspection outputs under the selected output directory.]\n\n## Skill Version(s):\n\n0.1.0 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.","readmeExcerpt":"Skill: MacCheck Owner: iluoyao Summary: An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:22:13.694Z | auto Initial release of mac-check-skill. - Launches a full, local hardware and system check for Mac devices, covering dev","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"cd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN"},{"language":"bash","snippet":"/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale "},{"language":"bash","snippet":"/bin/zsh scripts/run-full-check.sh --output-root --locale --no-open"},{"language":"bash","snippet":"cd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN"},{"language":"text","snippet":"完整验机意图 → Runtime Guard → Session → Collector → Facts → System Rules\n→ Self-contained HTML → Guided Hardware Flow → 页面报告"},{"language":"text","snippet":"/\n├── raw/\n│ ├── .out\n│ ├── .err\n│ └── .meta.json\n├── runtime.json\n├── facts.json\n├── system-results.json\n├── session.json\n└── MacCheck-.html"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: mac-check-skill\ndescription: 用于 Mac 验机。在当前 Mac 上进行一次完整的本地检测任务，可检测设备、系统、电池、安全、存储、网络等系统信息，以及内置页面工具可检测键盘、屏幕、声音、麦克风、摄像头、触控板和接口等信息。权限只读、数据本地、不联网，检测结果支持下载为 MD、PDF、PNG 报告。适用于 Mac 日常健康检查、新机或整备机验收、维修后复检、购买或出售前检查及故障排查。检测结果仅反映可观察到的状态，不构成 Apple 官方诊断、质量保证或交易承诺。\nversion: 2.0.1\nauthor: Eddy\n---\n\n# Mac 验机助手\n\n为用户启动一次完整、只读、默认离线的 Mac 检测。自动检测完成后，以本地 Session App 作为唯一操作界面；用户可在页面完成硬件检查、查看结论并直接下载报告。\n\n## 使用边界\n\n- 用户表达“验机”“Mac检测”“全面检查”“设备体检”“收货/维修验收”“购买或出售前检查”等完整检查意图时使用。\n- 当前版本固定创建完整 Session；若用户只想了解某个单项，应直接回答或说明该项能力，不要悄悄启动整套流程。\n- 支持能够在目标 Mac 上运行本地脚本并打开本地 HTML 的兼容 Agent 桌面宿主，不依赖特定产品、回调协议或对话持续运行。\n- 根据当前对话选择 `zh-CN` 或 `en-US`；无法判断时使用 `zh-CN`。\n\n## 无 Agent 终端运行\n\n本项目也可以在没有 Agent 桌面端的情况下直接运行。下载或解压项目后，用户可打开“终端”，进入项目根目录并执行：\n\n```bash\ncd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN\n```\n\n英文界面将 `zh-CN` 改为 `en-US`。系统检测完成后会自动打开本地硬件检测页面；如果页面未能自动打开，可使用终端输出中的 `SESSION_HTML` 路径手动打开。此方式与 Skill 执行流程复用同一入口，不需要 `chmod`、`sudo`、清除隔离属性或安装额外依赖。\n\n当 Agent 正在执行验机任务时，仍按下方“执行流程”直接调用入口，不要额外要求用户改用终端；仅在用户询问无 Agent 使用方法时提供上述说明。\n\n## 执行流程\n\n1. 简短告知用户：将运行只读系统检测，不使用管理员权限、不修改系统设置；默认不联网，也不上传序列号或结果。\n2. 用户同意后，读取 [architecture.md](references/architecture.md)、[privacy.md](references/privacy.md) 和 [agent-runtime.md](references/agent-runtime.md)。\n3. 必须显式使用 zsh 执行入口；不要依赖压缩包保留可执行权限，也不要要求用户 `chmod`：\n\n```bash\n/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale \n```\n\n4. 入口依次执行环境检查、Session 创建、系统采集、事实规范化、确定性规则判断、单文件 Session App 构建与打开。\n5. 成功后只需说明：系统自动检测已完成，检查页面已经打开；请用户在页面继续硬件检测并下载报告。\n6. 若系统不允许自动打开页面，向用户提供脚本输出的 `SESSION_HTML` 绝对路径。不要等待或要求用户把结果复制回聊天。\n\n测试或用户明确不希望打开页面时：\n\n```bash\n/bin/zsh scripts/run-full-check.sh --output-root --locale --no-open\n```\n\n## 正确性与安全\n\n- 只运行 [detection-catalog.md](references/detection-catalog.md) 中的只读命令；不使用 `sudo`、下载脚本、绕过锁定或修改系统的命令。\n- Collector 只记录事实；Normalizer 只规范化；只有 [rule-spec.md](references/rule-spec.md) 的确定性规则可以生成结论。读取失败必须标为 `UNKNOWN`，不能伪装成通过。\n- Session App 不执行 Shell、不读取相邻文件、不依赖 CDN、localhost、MCP、AI 回调或外部服务。Apple 保修入口只能由用户主动点击，页面不能后台提交序列号。\n- 浏览器无法可靠观察的 Touch ID、物理接口、Force Touch 和感官质量必须采用清晰的引导验证，不得冒充自动检测。\n- 不生成缺乏依据的综合评分，不写“放心购买”，不声称 Apple 官方检测或保证不存在任何管理与锁定风险。\n- 系统数据必须序列化和转义后注入 HTML。完整序列号只保存在本地 Session 与报告中，页面不得把它发往网络；用户主动前往 Apple 官网查询保修时自行决定是否提交。\n\n## 页面与报告\n\n- 状态以页面当前内存为准，`localStorage` 仅作尽力恢复；页面不写回 `session.json`。\n- 报告遵循 [report-spec.md](references/report-spec.md)。在线风险查询、支付、性能测试、硬盘测速和 AI 评估不属于当前阶段，相关 feature flag 保持关闭。\n\n## 失败处理\n\n- 单项命令失败：继续其他检测，将对应结果标为“无法读取/需要确认”。\n- 设备身份完全无法读取：停止构建页面，保留诊断文件并说明原因。\n- 页面构建失败：保留 `facts.json` 与 `system-results.json`，不要由 AI 临时拼接替代页面或报告。\n- 麦克风或摄像头权限失败：页面标为“无法确认”并允许重试，不能直接判断硬件损坏。"},{"path":"README.md","content":"# MacCheck Skill\n\n[简体中文](README.md) | [English](README.en.md)\n\n一款用于 Mac 检查的 Agent Skill。运行后会自动检测系统与设备信息，并打开本地页面，引导你完成键盘、屏幕、声音等硬件检查，最后生成可下载的验机报告。\n\n## 能做什么\n\n- 自动检查机型、系统、电池、存储、安全状态、网络和外设等信息。\n- 引导检查键盘、屏幕、声音、麦克风、摄像头、Touch ID、触控板和接口。\n- 自动识别不同 Mac 机型的硬件能力，并为未知新机型提供安全回退。\n- 下载 Markdown、PDF 或 PNG 格式的验机报告。\n- 支持简体中文和英文。\n\n## 使用方法\n\n下载或克隆本仓库，或在 Releases 中下载 `mac-check-skill.zip` 并解压，然后选择以下任一方式启动。\n\n### 通过 Agent 使用\n\n1. 在你使用的 Agent 桌面端（例如 WorkBuddy、Claude、Codex、Cursor 等），将本仓库作为 Skill 安装或导入。\n2. 对 AI 说：\n\n > 帮我检查这台 Mac。\n\nAI 会创建本次验机任务、自动完成系统检测，并打开硬件检测页面。按照页面引导完成检查后，即可直接下载报告。\n\n### 通过终端使用\n\n不使用 Agent 时，打开“终端”，进入解压后的项目根目录并运行：\n\n```bash\ncd /path/to/mac-check-skill\n/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN\n```\n\n请将 `/path/to/mac-check-skill` 替换为实际项目路径。系统检测完成后会自动打开本地硬件检测页面；如果未能自动打开，请在终端输出中找到 `SESSION_HTML` 路径并手动打开。检测数据保存在项目根目录的 `mac-check-output` 中。\n\n## 隐私说明\n\n- 默认在本机离线运行，不主动上传检测数据。\n- 系统检测均为只读操作，不会修改系统设置。\n- 检测结果与报告保存在本地；公开分享前请留意序列号等设备信息。\n\n## 使用提示\n\n受浏览器和 macOS 权限限制，Touch ID、屏幕坏点、声音质量、触控板手感和接口物理状态等项目仍需用户配合确认。检测结果仅供参考，不替代 Apple 官方诊断。\n\n## 致谢\n\n本项目的部分产品思路与设计灵感来源于 [MacCheck](https://github.com/andyhuo520/MacCheck)，感谢原作者及贡献者的优秀工作。"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn77991za3nvfyfaq0fcgre66s8ca9xh\",\n \"slug\": \"mac-check-skill\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1786519333694\n}"},{"path":"references/agent-runtime.md","content":"# Agent 桌面运行环境\n\nP0 将真实 `Darwin` 主机视为可检查环境。运行 `scripts/runtime-check.sh `，验证 `/usr/sbin/system_profiler`、`/usr/bin/osascript`、`/usr/bin/open` 等本地能力是否存在。\n\n兼容宿主可能从压缩包、缓存目录或沙箱工作区安装 Skill，因此不能假设文件保留 Unix 可执行位。所有对项目内 shell 文件的调用都必须显式使用 `/bin/zsh