Home / xiaochangxu / heartratemonitor-composeui · GitHub

Android心率监测项目开发规范 SKILL.md skillA

Android心率监测项目开发规范 from xiaochangxu/heartratemonitor-composeui is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add xiaochangxu/heartratemonitor-composeui/Android心率监测项目开发规范@git:20260904.a2a1bb8

Pins git:20260904.a2a1bb8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
xiaochangxu/heartratemonitor-composeui
Path
android/skill/SKILL.md
Versions recorded
2
Latest version
git:20260904.a2a1bb8, committed Sep 4, 2026
First version recorded
Sep 4, 2026
Size
7,680 bytes
Repository stars
222
License
MIT

Android 心率监测项目开发规范。当新增或修改 Kotlin/Compose 代码、调整分层与模块边界、增删 DataStore 设置项、改动 BLE 心率数据流或落盘链路、处理 WindowInsets 避让与 i18n 数字渲染、或改完需执行 gradlew 验证基线时，必须先加载本 Skill。内含 13 条禁止破坏的架构契约（详情见 docs/contracts/）与验证基线。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 使用流程

1. 确认改动涉及哪一层 → 查阅下方对应契约的详情文件
2. 改动完成 → 判断改动范围：
   - **较大改动或用户要求时**：执行「验证基线」中的全量命令
   - **小改动**（文案/样式/间距/简单逻辑/UI调整）：可只跑 `assembleDebug` 或跳过，由用户决定
3. 涉及 BLE 连接/断开/重连、设置热更新 → 提示用户真机回归

# 项目规则

- 禁止未经用户允许就将代码提交到远程仓库
- 禁止排除 android 目录下的 .key 文件夹（用户要求密钥入库）

# 架构速览（2026-09 多 Activity 迁移后）

- 导航：`MainActivity` 只承载 4 Tab；其余页面各自独立 Activity（`:app` `ui/page/`，18 个）；navigation3 已整体删除
- 路由：`Destination` + `Context.launchDestination`（300ms 同路由防抖）；feature 层用 `Screen.route` 字符串，禁止 import `:app` 的 Activity
- 宿主：二级页 Activity 继承 `BaseComposeActivity`（主题/语言/edge-to-edge/openExternal 统一）
- 转场：100% 系统默认，禁止自定义动画资源（决策 D5）
- 控制面：`BleControlPlaneRegistry` 进程级注册活服务（契约 3）；数据面 `HeartRateRepository`（契约 13）
- 迁移决策与全记录：`docs/spec-multi-activity-migration.md`；导航架构契约见契约 9.7

# 通用原则

- 优先官方文档 > 官方最佳实践 > 稳定版本文档；与官方指导冲突时以官方为准
- 可维护性优先于开发速度，简洁性优先于不必要的复杂设计
- 禁止编造 API、文档内容、版本信息、性能数据、项目事实；不确定就查官方文档或明确说明
- 保持架构模块化、单一职责、低耦合高内聚、避免循环依赖、集中管理共享功能、不重复已有实现；除非明确要求，否则不改变项目架构
- 默认最小化修改：不改无关文件/代码，不做未经请求的重构
- 新增代码必须与现有项目风格一致，统一为新写法，禁止新旧写法混用
- 优先渐进式改进，而非大规模重写
- 优先使用项目已有技术，没有充分理由不要引入新框架

# 通用代码规范

- **代码风格**：清晰命名、小型函数/类、不可变数据、可读代码、单一职责；避免超长方法、巨大类、重复代码、过深嵌套、魔法数字、不必要全局状态
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add xiaochangxu/heartratemonitor-composeui/Android心率监测项目开发规范@sha256:8bc0464cd84707b4

The line at the top of this page pins the label git:20260904.a2a1bb8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bdt7axwmps3m4otn.svg)](https://markdownregistry.com/a/art_bdt7axwmps3m4otn)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Sep 4, 2026.

versioncommittedcommitsizeaudit
git:20260904.a2a1bb8 latest2026-09-04 a2a1bb8 7,680 BA view · diff
git:20260904.b997d622026-09-04 b997d62 6,911 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7680 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

xiaochangxu/heartratemonitor-composeui · 222 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bdt7axwmps3m4otn
GET https://markdownregistry.com/api/v1/resolve?ref=xiaochangxu/heartratemonitor-composeui/Android心率监测项目开发规范
GET https://markdownregistry.com/api/v1/blob/8bc0464cd84707b452e612ec27d70f184e16091ea6fe0de816e8d18748ec83a8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

Browse by kind, by grade A, or by owner.