初始化神之一手（divine-lot-dev）skill：面向文档的AI Native项目开发框架
This commit is contained in:
@@ -0,0 +1,116 @@
|
||||
---
|
||||
name: divine-lot-dev
|
||||
description: 神之一手（divine-lot-dev）—— 最强的 AI Native 项目开发逻辑：面向文档的开发模式，由人与 AI Code Agent 的反复讨论驱动。通过 docs 下「终极目标 / 计划 / 设计约束 / 迭代记录 / 需求池」五个强约束目录管理项目；支持项目初始化（自动建立目录结构）。当用户要求在本项目内开发、讨论、规划或复盘时使用本技能。
|
||||
whenToUse: 在 one_divine_lot 仓库中从事任何开发、规划、讨论、审查或复盘工作前，先阅读本技能对齐神之一手框架；项目约定与本技能冲突时以本技能为准。
|
||||
---
|
||||
|
||||
# 神之一手（divine-lot-dev）
|
||||
|
||||
**神之一手** = 最强的 AI Native 项目开发逻辑。
|
||||
|
||||
核心思想：**项目由文档驱动，文档由讨论产生**。人与 AI Code Agent 通过反复讨论推进项目，每一次讨论的结论都以强约束文档的形式沉淀在 `docs/` 下，文档反过来约束后续的每一次开发动作。
|
||||
|
||||
## 1. 工作模式：面向文档的讨论式开发
|
||||
|
||||
```
|
||||
讨论（人 ↔ AI） → 结论沉淀为文档 → 文档强约束下一步动作 → 执行 → 记录 → 复盘 → 新一轮讨论
|
||||
```
|
||||
|
||||
- **讨论是发动机**：需求、方案、取舍都先讨论清楚，再落文档、再动代码。
|
||||
- **文档是刹车和方向盘**：一切开发动作必须可回溯到某个文档条目；文档未覆盖的改动不允许发生。
|
||||
- **Agent 的角色**：不只是写代码，而是参与讨论、维护文档、按文档执行、诚实记录结果。
|
||||
|
||||
## 2. docs/ 五大强约束目录
|
||||
|
||||
`docs/` 下五个目录各自承担唯一职责，**职责不可混淆、不可绕过**。目录名带序号，**序号即流程顺序**：从 01 到 05 完整走完一轮项目推进，阅读与执行都按序号从头到尾进行。每个目录内有 `说明.md` 定义其角色与强约束（细节随讨论演进）。
|
||||
|
||||
| 目录 | 角色（一句话） | 强约束（初始定义） |
|
||||
|---|---|---|
|
||||
| `01-终极目标/` | 项目存在的唯一理由 | 内容唯一；变更必须经重大讨论并记录理由；是其他一切目录的最终裁决依据 |
|
||||
| `02-计划/` | 目标分解后的执行方案，支持不同粒度 | 必须从终极目标派生；计划条目必须有明确范围与验收；计划未覆盖的事不做 |
|
||||
| `03-设计约束/` | 设计与技术的强制规范，下分三个文档模块（产品功能 / 技术方案 / UI交互） | 后续迭代必须以本目录为依据；规范变更需讨论并记录理由；不得与终极目标冲突 |
|
||||
| `04-迭代记录/` | 执行过程的事实档案，每次迭代一个子目录（迭代目标 / 技术实现方案 / 验收标准） | 只记录事实（做了什么、结果如何），不写感想；追加式，不改写历史 |
|
||||
| `05-需求池/` | 所有待办需求的入口 | 统一格式登记；有优先级与状态流转（池 → 计划 → 完成）；讨论中的想法先入池 |
|
||||
|
||||
> **设计约束的文档模块**：`03-设计约束/` 下三个文档模块，各自以**列表**记录约束条目，每条含「编号 / 约束说明 / 添加日期 / 生效状态 / 失效日期 / 最后一次变更描述」：
|
||||
> - `产品功能约束.md`：产品功能层面的约束（功能边界、行为定义、不可违背的产品规则）
|
||||
> - `技术方案约束.md`：技术方案层面的约束（技术栈、架构、实现规范、依赖原则）
|
||||
> - `UI交互约束.md`：UI 与交互层面的约束（视觉风格、组件、交互行为）
|
||||
> - 后续讨论确定的设计/技术/产品约束与变更，直接更新对应模块列表：新增条目追加、变更条目更新说明与日期、失效条目标记状态与失效日期。引用时用编号（如 `产品约束-001`）。
|
||||
> - **最后一次变更描述**：概括该约束最近一次变更（新增 / 变更 / 失效）讨论的最后一层结论，写入该列以便追溯；新增时写"新增"讨论的结论，变更/失效时更新为当次讨论的结论。
|
||||
|
||||
> **迭代记录的组织结构**：`04-迭代记录/` 下每次迭代一个子目录。目录已位于迭代记录下，目录名不再重复"迭代"前缀，直接为 **`<编号>-<目标名称>`**（如 `01-建立神之一手框架`），编号放最前、后面直接跟本次迭代的目标名称，子目录内含三份文档：
|
||||
> - `迭代目标.md`：本次迭代的目标、目标描述、目标的讨论过程，以及对项目主理人（老师）的配合需求
|
||||
> - `技术实现方案.md`：实现该目标对应的技术实现方案
|
||||
> - `验收标准.md`：本次迭代的验收标准线（验收标准在哪里）、验收方法、验收目标 —— 明确如何判定本次迭代是否达成
|
||||
> - **与需求池联动**：迭代目标若引用需求池中的需求，需求池索引记录需补充「实现该需求的迭代」与「需求实现状态」两要素，双向可追溯。
|
||||
|
||||
> **关于粒度**：计划不是单一粒度。一个计划可以是"概念范围大一些的阶段航点"，也可以是"可直接执行的小任务"。两者本质相同 —— 都是对目标的分解 —— 只是范围大小不同，统一归入 `02-计划/`，通过粒度标记区分。
|
||||
|
||||
### 文档之间的流转关系
|
||||
|
||||
```
|
||||
05-需求池 ──(讨论排优先级)──▶ 02-计划 ──(执行)──▶ 04-迭代记录
|
||||
▲ │
|
||||
└────────(复盘，对照计划)─────────────────────┘
|
||||
│
|
||||
▼
|
||||
03-设计约束 ◀──(迭代须依据)── 02-计划
|
||||
│
|
||||
▼
|
||||
01-终极目标 ──(验证)──▶ 持续迭代
|
||||
```
|
||||
|
||||
> 注：序号反映**阅读与裁决的层级顺序**（01 最高），实际推进节奏按 `05 → 02 → 04 → 01` 的流转闭环走，且每次进入计划/执行都必须先对照 `03-设计约束`，两者不冲突。
|
||||
|
||||
## 3. 功能：项目初始化
|
||||
|
||||
**触发时机**：在新项目 / 空项目初始化时，建立当前项目的目录结构。
|
||||
|
||||
**初始化动作**：
|
||||
|
||||
1. 建立 `docs/` 五大强约束目录：`01-终极目标/`、`02-计划/`、`03-设计约束/`、`04-迭代记录/`、`05-需求池/`。
|
||||
2. 每个目录写入 `说明.md` 骨架：角色 / 强约束（初始定义）/ 待讨论细节，内容与本节框架一致。
|
||||
3. `03-设计约束/` 下建立三个文档模块：`产品功能约束.md`、`技术方案约束.md`、`UI交互约束.md`，各含六列列表骨架（编号 / 约束说明 / 添加日期 / 生效状态 / 失效日期 / 最后一次变更描述）。
|
||||
4. 检查 `.agents/skills/divine-lot-dev/` 是否存在（skill 本身），不存在则提示先安装 skill。
|
||||
|
||||
**初始化原则**：
|
||||
|
||||
- **不覆盖**：已存在的目录或文件不重复创建、不覆盖已有内容。
|
||||
- **可校验**：初始化完成后输出目录结构清单，供确认。
|
||||
|
||||
## 4. 开发流程（框架层）
|
||||
|
||||
1. **新想法 → 需求池**：任何新需求、新想法先登记入池，不直接进代码。
|
||||
2. **需求 → 讨论 → 计划**：对池内需求进行讨论，确定优先级与范围后，从终极目标派生计划（含大粒度阶段航点与小粒度任务，按需拆分）。
|
||||
3. **计划 → 对照设计约束 → 执行**：进入计划与执行前，先对照 `03-设计约束/` 中的设计/技术/产品设计规范，确保实现有规范依据。
|
||||
4. **计划 → 执行 → 迭代记录**：按计划执行，每次迭代的事实写入迭代记录。
|
||||
5. **迭代 → 复盘 → 计划/需求池**：对照计划检查进度，更新计划状态与需求池流转。
|
||||
6. **计划 → 终极目标**：阶段性验证，确认终极目标的推进与修正。
|
||||
|
||||
## 5. 质量门禁（框架层）
|
||||
|
||||
- **文档先行**：代码改动必须有对应文档条目（计划/需求池）支撑。
|
||||
- **规范约束**：实现必须符合 `03-设计约束/` 的规范；无规范依据的实现需要先补规范或讨论豁免。
|
||||
- **记录诚实**：迭代记录只写事实，成功失败都记录，失败是复盘的原料。
|
||||
- **约束优先**：文档强约束 > 临时便利；违反约束的改动需要讨论并修订文档。
|
||||
|
||||
## 6. 与 DSH 的协作约定
|
||||
|
||||
- 若功能以 DSH 插件形式提供，遵循 DSH 的 Cordis 插件规范：`apply(ctx)` 内使用 `ctx.effect()`/`ctx.on()` 管理副作用，`ctx.get(name)` 读取可选服务，插件命名用 `name`/`inject`/`apply` 形式导出。
|
||||
- 复用 DSH 内置能力（文件、shell、MCP、subagent 等）优先于自行实现。
|
||||
- 修改 DSH 宿主组成（host composition）或 agent preset 前，先加载 `editing-cordis-compositions` 技能。
|
||||
|
||||
## 7. 待讨论的细节（随讨论逐步填充）
|
||||
|
||||
> 以下为框架已定、细节待讨论的开放问题清单，每轮讨论聚焦其中一项，结论回写本技能与对应 `说明.md`。
|
||||
|
||||
- [ ] 终极目标：文档格式、变更流程、与计划的校验关系
|
||||
- [ ] 计划：粒度的区分方式（如何标记阶段航点 vs 小任务）、完成标准写法、依赖表示方式、与迭代的对应关系
|
||||
- [x] 设计约束：文档模块与记录格式（三个模块：产品功能 / 技术方案 / UI交互；列表条目含编号、约束说明、添加日期、生效状态、失效日期）
|
||||
- [ ] 设计约束：变更流程、与计划的校验关系
|
||||
- [x] 迭代记录：组织结构（每次迭代一个子目录，含迭代目标 / 技术实现方案 / 验收标准；与需求池索引联动）
|
||||
- [ ] 迭代记录：验收标准的写法（标准线如何划定、验收方法、验收目标）
|
||||
- [ ] 迭代记录：记录粒度、编号规则、复盘模板
|
||||
- [ ] 需求池：登记格式（含"实现迭代 / 实现状态"联动字段）、优先级规则、状态流转的具体定义
|
||||
- [ ] 讨论本身的规范：讨论如何发起、如何收敛、如何判定"讨论完成"
|
||||
Reference in New Issue
Block a user