Skip to content
Skills Library
Programming · Building & coding

ddcomponent

/ddcomponent

Use this skill whenever the user asks to create a new page, list, component, or feature using DDComponent. Trigger on: DDComponent, ViewPresenter, PageViewController, RootViewPresenter, PresenterInstaller, ServiceInstaller, setState, reusable presenter, "create a page", "build a list", "add a component", "MVP pattern", or any mention of P-Tree/V-Tree. This skill guides the user from big (page) to small (single Presenter) through the framework's design philosophy and code patterns.

Repository
ddcomponent ↗
Licence
MIT
Last repository change
21.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use this skill whenever the user asks to create a new page, list, component, or feature using DDComponent. Trigger on: DDComponent, ViewPresenter, PageViewController, RootViewPresenter, PresenterInstaller, ServiceInstaller, setState, reusable presenter, "create a page", "build a list", "add a component", "MVP pattern", or any mention of P-Tree/V-Tree. This skill guides the user from big (page) to small (single Presenter) through the framework's design philosophy and code patterns.

Triggers from the description

create a pagebuild a listadd a componentMVP pattern
Original author description

Use this skill whenever the user asks to create a new page, list, component, or feature using DDComponent. Trigger on: DDComponent, ViewPresenter, PageViewController, RootViewPresenter, PresenterInstaller, ServiceInstaller, setState, reusable presenter, "create a page", "build a list", "add a component", "MVP pattern", or any mention of P-Tree/V-Tree. This skill guides the user from big (page) to small (single Presenter) through the framework's design philosophy and code patterns.

How it works

  1. 核心设计思想
  2. 决策树
  3. 生命周期顺序
  4. 关键规则
  5. Reference 索引
Original SKILL.md headings · 62 lines, 232 words
SKILL.md preview
---
name: ddcomponent
description: >
  Use this skill whenever the user asks to create a new page, list, component, or feature
  using DDComponent. Trigger on: DDComponent, ViewPresenter, PageViewController,
  RootViewPresenter, PresenterInstaller, ServiceInstaller, setState, reusable presenter,
  "create a page", "build a list", "add a component", "MVP pattern", or any mention of
  P-Tree/V-Tree. This skill guides the user from big (page) to small (single Presenter)
  through the framework's design philosophy and code patterns.
---

# DDComponent 页面拆分框架

你是一个 DDComponent 专家。帮助用户使用 DDComponent 框架构建 iOS 页面。

## 核心设计思想

1. **View 是协议,不是 UIView**。View 代表"数据消费的终点",可以是 UI 按钮,也可以是埋点服务。同一个 Presenter 可以绑定到完全不同的 View 实现。

2. **所有 UI 更新走 setState**。View 是状态机,借鉴 React/SwiftUI。`setState` 统一入口,由 Pipeline 批量调度 `onUpdate`。直接修改 View 会导致状态不一致、复用错乱。

3. **Presenter 是业务逻辑的复用单元**。一个 Presenter 只做一件事。臃肿时继续拆分。View 类型为 Service 类型时退化为纯逻辑单元。

## 决策树

```
用户要做什么?
├── 创建新页面
│   ├── 固定布局(详情页、信息流)→ references/page-and-list.md
│   └── 列表(TableView/CollectionView)→ references/page-and-list.md
├── 创建/拆分 Presenter、理解生命周期 → references/presenter.md
├── 状态更新、动画、通信 → references/state-communication.md
├── 使用 use* API → references/use-methods.md
└── 需要完整示例 → references/examples.md
```

## 生命周期顺序

```
init() → onAttach → onAttachToRoot → onBindView → onUpdate (×N) → onUnbindView → onDetach → onDetachFromRoot → deinit
```

## 关键规则

### ✅ DO

- **View 必须定义为协议**(`ViewPresenter<UIButton>` ❌,`ViewPresenter<MyProtocol>` ✅)
- **所有 UI 更新通过 `setState {}`**,不直接 `view?.xxx = yyy`
- **`onBindView` 中设回调、`onUnbindView` 中清回调**,先调 `super`
- **子 Presenter 必须 `add(child:)` 加入 P-Tree**
- **异步回调用 `[weak self]`**
- **Service/子 Presenter 在 `pageInstallers` 或 RootPresenter 的 `init()` 中注册**
- **Swift 6 下 use* 用 `lazy var` + 显式类型标注**

### ❌ DON'T

- **不用 UIView 作为 View 类型**
- **不在 `setState` 外部修改影响 UI 的状态**
- **不在 `setState` 闭包内执行副作用**(网络、埋点等)
- **不在 `pageInstallers` 中注册 RootPresenter** — `makePresenter()` 已创建
- **不忘记清理回调**
- **不在生命周期方法中调用 use\*** — 只能在 `init()` 或属性初始化器中

## Reference 索引

| 文件 | 何时读取 |
|---|---|
| `references/page-and-list.md` | 创建页面(固定布局/列表)、自动布局计算、layoutInfo |
| `references/presenter.md` | 创建/拆分 Presenter、生命周期方法职责、拆分原则 |
| `references/state-communication.md` | setState/onUpdate、动画 Animator、Service/Notify 通信 |
| `references/use-methods.md` | use* 声明式 API 完整用法 |
| `references/examples.md` | 完整端到端示例(Like、列表、use* 等) |
Files in this package (6)
  • SKILL.md 3 KB
  • references/examples.md 3 KB
  • references/page-and-list.md 4 KB
  • references/presenter.md 6 KB
  • references/state-communication.md 4 KB
  • references/use-methods.md 2 KB

Versions

The database has no other skills named ddcomponent.

Database snapshot: 13.11.2026 · package version dee3e0d936bd (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96rerender-functional-setstate
    Use functional setState updates to prevent stale closures and unnecessary callback recreations. Apply when updating state based on the current state value in React components.
  • 100component-docs-page
    This skill should be used when the user asks to "add X to the docs site", "create the docs page for a new component", "document the new X component", "add a usage page for X", or otherwise discusses publishing a component (new, migrated, or undocumented) on the `docs/` site. It…
  • 100web-page
    Scaffold a new page or component for the Lumen Next.js web app. TRIGGER when user asks to create, add, or build a new page, route, or dashboard section.
  • 100component-design
    Create or restructure a UI component — architecture, component patterns, accessibility, design-system rules. Use when adding a new component, splitting a large one, or making one reusable. App-level work belongs to frontend-ui-engineering.
  • 90frontend-component
    Use when a ticket asks to add or change a UI component — a new widget, a reusable element, a page section, or a state/variant of one — in a frontend stack. Invoke for "add a Card component", "build the settings panel", or "add a loading state to X". Match the repo's component…
  • 100react18-batching-patterns
    Provides exact patterns for diagnosing and fixing automatic batching regressions in React 18 class components. Use this skill whenever a class component has multiple setState calls in an async method, inside setTimeout, inside a Promise .then() or .catch(), or in a native event…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.