# geekx-app-forge

Adopt this skill: https://proskills.md/skills/other/geekjourneyx-geekx-skills-skills-geekx-app-forge

Page: https://proskills.md/skills/other/geekjourneyx-geekx-skills-skills-geekx-app-forge
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/geekx-app-forge/SKILL.md
size: 6256
upstream: https://github.com/geekjourneyx/geekx-skills/blob/main/skills/geekx-app-forge/SKILL.md

````text
---
name: geekx-app-forge
description: 当用户有模糊产品想法、想做 App 或工具，但真实需求、范围、成功标准、技术可行性或商业化边界尚未确认时使用。尤其适合自用起步但可能商业化、需求容易膨胀、Apple 平台体验要求高、静态内容较多或需要在立项前判断是否值得做的产品探索场景。
---

# GeekX App Forge

把“我好像想做个东西”锻造成**值得做、范围清楚、体验克制、可直接开发**的产品交付包。

核心不是更快写 Spec，而是先证明：**为什么要做、真正要解决什么、最小产品是什么、什么绝对不做。**

## 硬门槛

1. **先查再问。** 能从上下文、文件、仓库、官方文档或公开资料确认的事实，不问用户。
2. **先怀疑需求。** “能做”不等于“该做”；AI Coding 降低开发成本，不等于降低维护和产品复杂度。
3. **至少 10 轮有效澄清。** **REQUIRED SUB-SKILL:** 使用 `geekx-grilling`，一次一问。每轮必须改变目标、范围、用户、成功标准、风险或路线；禁止凑数。
4. **推荐不等于确认。** 用户没有明确选择，就不能关闭分支。
5. **先自用，再商业化。** 先验证自己的高频真实痛点，再检查是否存在可复制人群、付费理由和差异化。
6. **先删再加。** 每个功能都问：`这是用户真正要的吗？删掉会不会更好？现在不做会怎样？`
7. **确认前不写 Spec。** 需求、非目标和主要风险未关闭时，不进入设计资产。
8. **交付必须可开发。** 已经调研过的静态数据、文案、分类、图标规范、App identity 不得甩给 Coding Agent 重新研究。

## 阶段门

### Gate 0 — 还原真正动机
先确认：
- 为什么现在产生这个想法；
- 当前真实场景和频率；
- 不做 App 时用户如何解决；
- 用户说要 A，底层是不是其实要 B；
- 这是持续问题、一次性问题，还是“因为现在容易开发所以想做”。

随后进入至少 10 轮 `geekx-grilling`。读取 `references/grilling-and-reality-check.md`。

### Gate 1 — Reality Check
对已经形成的主张做反方审查：
- 伪需求风险；
- 使用频率是否足够；
- 是否已有更轻的替代方案；
- 技术可行性与平台限制；
- 最大复杂度税；
- 最可能失败的假设；
- 最低成本验证；
- 什么证据会让我们停止。

证据不足时只能标记“待验证”，不能装成事实。

### Gate 2 — Evidence Chain
对会改变决策的事实做调研。优先级：
1. 官方/一手资料；
2. 原始仓库、API、平台政策；
3. 真实用户/社区反馈；
4. 竞品与商业信号；
5. 二手分析仅作补充。

读取 `references/evidence-and-commercialization.md`。输出证据、反证、未知项和结论权限。

### Gate 3 — Product Shape
把想法压成：
- 目标用户；
- 核心任务；
- 高频触发场景；
- 一句话价值；
- P0；
- 明确非目标；
- 成功标准；
- 最小验证；
- P0.5/P1 只作为延期项。

如果 P0 仍像一个平台，继续删。

### Gate 4 — Commercialization Lens
先保证自用价值成立，再回答：
- 哪类人和我有同样痛点；
- 为什么他们会持续使用；
- 为什么现有方案不够；
- 什么能力可形成差异；
- 谁可能付钱、为什么；
- 商业化会不会反过来污染 P0。

商业化不是强行加账号、订阅、云服务；只是保留未来路径。

### Gate 5 — Design Freeze
若为 Apple 平台，读取 `references/apple-native-product-design.md`。
默认：Apple HIG、系统组件、SF 字体、semantic colors、内容优先、低认知负担。禁止把“高级感”翻译成渐变、玻璃、阴影、卡片墙。

用户明确确认目标、P0、非目标、体验方向后，才进入正式设计。

### Gate 6 — Spec → Plan
**REQUIRED SUB-SKILL:** 使用 `superpowers:brainstorming` 写 Product + Design Engineering Spec；复用已确认决定，不重新发散需求。

用户批准 Spec 后：
**REQUIRED SUB-SKILL:** 使用 `superpowers:writing-plans` 写 Implementation Plan。

Spec 和 Plan 必须保持同一套名称、范围、数据结构、文案和验收标准；发现冲突先修文档，不让实现 Agent 猜。

### Gate 7 — Static Data & App Identity
在交付前补齐 Coding Agent 不应该重新研究的内容：
- App 名称、英文名、Repo、Bundle ID、平台和最低版本；
- Tab/导航名称；
- 用户可见固定文案；
- 首批 seed；
- 枚举/分类/manifest；
- 已研究的数据集与来源映射；
- 本地通知固定文案；
- 导出格式；
- Icon 概念、禁止项、Light/Dark/Tinted 规则；
- 设计 tokens/系统语义；
- 任何可直接 import 的 JSON/CSV/Markdown。

读取 `references/developer-handoff.md`。

### Gate 8 — Developer Handoff ZIP
最终交付至少包含：

```text
AGENTS.md
README.md
docs/
  product/
  research/
  plans/
  handoff/
Resources/
  Seeds/
```

根据项目实际删掉不需要的目录；**不要为了模板完整制造空文件。**

交付前审查：
- Coding Agent 是否还需要重新做产品研究？
- 是否还有 TBD / TODO / “自行决定”？
- 静态数据能否直接导入？
- App 名称/Icon/文案是否明确？
- P0 与延期项是否分开？
- 是否出现未经确认的新功能？
- 是否有过度设计？
- ZIP 解压后是否能直接开始 Task 1？

## STOP 条件

出现任一情况，停止进入开发计划：
- 真实痛点证据不足；
- 低频一次性需求，轻量替代已足够；
- 核心技术假设未验证；
- 用户仍未确认关键范围；
- P0 主要由“以后可能需要”组成；
- 商业化假设依赖虚构用户；
- 维护成本明显高于可获得价值。

此时输出 `不做 / 先验证 / 缩小 / 转向`，而不是为了产出 ZIP 强行继续。

## 最终原则

> 先证明值得做，再决定做什么；先把产品变简单，再把交付变完整。

如果一个功能不能明显帮助核心任务，删掉。
如果一份文档不能减少实现歧义，删掉。
如果 Coding Agent 还需要重新研究已经研究过的东西，交付还没完成。
````

## File: README.md
upstream: https://github.com/geekjourneyx/geekx-skills/blob/main/README.md

````text
<p align="center">
  <img src="./assets/readme/hero.svg" width="100%" alt="GeekX Skills：把工程架构中的判断、约束与取舍沉淀为可执行的 Agent 技能">
</p>

---

## 这是什么

GeekX Skills 是 [geekjourneyx](https://github.com/geekjourneyx) / 极客杰尼的 Agent 技能合集。

它不追求把所有想法都变成流程，而是把真实工作里反复出现、容易跑偏、需要稳定判断的环节沉淀成技能。

## 为什么需要它

Agent 很擅长补全方案，也很容易跳过关键决策，或把一个小需求扩写成完整系统。

- `geekx-gate`：先砍噪音、算复杂度税、确认非目标，再决定是否进入设计。
- `geekx-grilling`：一次追问一个关键决定，给出推荐项和备选理由，在行动前形成共同理解。
- `geekx-app-forge`：把模糊产品想法先做真实性与必要性审查，再收敛成可直接交给 Coding Agent 的开发交付包。

## 核心能力

`geekx-gate` 强制 Agent 输出一个裁决，而不是输出一套越来越大的计划：

- 保留、砍掉、延期、先验证或缩小范围
- 跳过、`STOP`、`HOLD` 或 `PROBE`
- 真实需求、噪音、非目标、复杂度税和唯一下一步

`geekx-grilling` 强制 Agent 把提问变成可决策的选项：

- 一次只问一个高影响问题
- 按依赖顺序关闭重大决策分支，不遗漏仍有效的并行决定
- 推荐项排第一，并说明第一性原理和逆向理由
- 每个备选项都说明适用条件、代价和风险
- 有结构化提问工具时必须调用
- 达成共同理解前不行动

`geekx-app-forge` 用于从模糊想法走到开发交付：

- 至少 10 轮有效澄清，先验证真实痛点再写 Spec
- 强制做伪需求、替代方案、复杂度税和技术可行性审查
- 先满足自己的真实需求，再评估可复制用户与商业化可能
- Apple 平台默认采用 Apple-native、低认知负担和反过度设计约束
- 把静态数据、固定文案、App identity、Icon 规范一起交付，不让 Coding Agent 重新研究
- 保留 `PROBE / SHRINK / STOP` 出口，不为了产出 App 强行立项

## 可用技能

| 技能 | 适合什么时候用 |
|:---|:---|
| `geekx-engineering` | 在真实代码库中实现功能、修复重大缺陷、重构或迁移，维护任务连续性并验证交付结果。 |
| `geekx-gate` | 审查需求、工程计划、架构提案、路线图或 Agent 输出是否过度设计；判断重写、框架、插件系统、工作流引擎等难撤回技术决定现在该不该做。 |
| `geekx-grilling` | 通过连续单题追问压力测试计划、决定或想法；要求每个问题提供推荐项、备选项和理由，并在行动前确认共同理解。 |
| `geekx-app-forge` | 从模糊产品想法出发，先验证需求与可行性，再收敛 P0、Apple-native 体验、静态数据和开发交付包。 |

## 快速开始

安装全部技能：

```bash
npx skills add geekjourneyx/geekx-skills --all
```

查看可用技能：

```bash
npx skills add geekjourneyx/geekx-skills --list
```

只安装 `geekx-gate`：

```bash
npx skills add geekjourneyx/geekx-skills --skill geekx-gate
```

只安装 `geekx-grilling`：

```bash
npx skills add geekjourneyx/geekx-skills --skill geekx-grilling
```

只安装 `geekx-engineering`：

```bash
npx skills add geekjourneyx/geekx-skills --skill geekx-engineering
```

只安装 `geekx-app-forge`：

```bash
npx skills add geekjourneyx/geekx-skills --skill geekx-app-forge
```

## 使用示例

```text
使用 geekx-engineering 在现有代码库中实现这个需求，并完成相关验证。
```

```text
使用 geekx-gate 审查这个方案是否过度设计。
```

```text
使用 geekx-gate 找出这个需求的最小必要升级。
```

```text
使用 geekx-gate 判断现在要不要引入插件系统。
```

```text
使用 geekx-gate 判断这次重写是否有足够证据。
```

```text
开庭。使用 geekx-gate 多线程审判这个路线图，判断哪些该砍掉。
```

```text
使用 geekx-grilling 逐项追问这个产品计划，每次只问一个关键问题。
```

```text
Grill me。给出推荐项和备选项，并解释每个选择的代价。
```

```text
使用 geekx-app-forge 把这个模糊 App 想法先问透、查实、砍到最小，再生成可直接交给 Coding Agent 的开发交付包。
```

## 技能约束

每个技能都遵守这些仓库级约束：

- 目录名必须以 `geekx-` 开头。
- `SKILL.md` 的 `name` 必须与目录名一致。
- 每个技能必须包含 `evals/evals.json`。
- 用户可读内容默认使用中文；机器标识、命令和固定协议值保持原样。
- README 只列用户需要知道的技能；维护规则以 `AGENTS.md` 为准。

## 作者

- 主页：[jieni.ai](https://jieni.ai)
- GitHub：[@geekjourneyx](https://github.com/geekjourneyx)
- X：[@seekjourney](https://x.com/seekjourney)
- 公众号：极客杰尼

## 许可证

[MIT](./LICENSE)
````
