ironweave 1.0.0

package/skills/code-scaffold/SKILL.md

@@ -0,0 +1,313 @@
+---
+name: code-scaffold
+description: >-
+  从设计文档生成项目代码骨架——包括目录结构、分层架构、Entity/Repository/Service 骨架、配置文件和测试框架初始化。执行阶段的核心工具，将 Plan 阶段产出的领域模型、时序设计、组件设计转化为可编译运行的项目框架。
+  务必在以下场景使用本 skill：用户要求初始化项目、生成代码骨架、搭建项目结构、创建 Entity、创建 Repository、创建 Service、项目脚手架、scaffold、项目初始化、从设计到代码、组件结构生成、代码生成、模块注册，或涉及 steps/09 时序设计和 steps/10 组件设计到实际代码的转化工作。
+---
+
+# 代码骨架生成
+
+从领域模型 + 时序设计 + 组件设计出发，产出可编译运行的分层项目骨架。
+
+---
+
+## 生成流程
+
+```mermaid
+graph TB
+    INPUT["设计文档输入<br>领域模型 + 时序设计 + 组件设计"] --> SCAN["上下文扫描<br>技术栈 + 构建工具 + 目录约定"]
+    SCAN --> INIT["项目初始化<br>构建配置 + 依赖管理"]
+    INIT --> LAYER["分层骨架<br>按架构生成目录与基类"]
+    LAYER --> DOMAIN["领域层代码<br>Entity + VO + Repository 接口"]
+    DOMAIN --> APP["应用层代码<br>Service + Command + Query"]
+    APP --> INFRA["基础设施层<br>RepositoryImpl + Mapper + 配置"]
+    INFRA --> TEST["测试骨架<br>测试配置 + 样板测试"]
+
+    style INPUT fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
+    style SCAN fill:#fff3e0,stroke:#e65100,color:#bf360c
+    style INIT fill:#e8eaf6,stroke:#283593,color:#1a237e
+    style LAYER fill:#e8eaf6,stroke:#283593,color:#1a237e
+    style DOMAIN fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
+    style APP fill:#c8e6c9,stroke:#2e7d32,color:#1b5e20
+    style INFRA fill:#ffe0b2,stroke:#e65100,color:#bf360c
+    style TEST fill:#f3e5f5,stroke:#6a1b9a,color:#4a148c
+```
+
+---
+
+## 1. 上下文扫描
+
+生成前先确认以下信息（从 project-context / tech-stack 获取或询问用户）：
+
+| 扫描项 | 影响 | 示例 |
+|--|--|--|
+| 语言 / 框架 | 目录结构模板 | Java + Spring Boot / TypeScript + NestJS |
+| 构建工具 | 配置文件 | Gradle / Maven / pnpm / npm |
+| 架构模式 | 分层策略 | 分层架构 / 六边形 / 模块化单体 |
+| ORM / 数据访问 | Repository 实现 | MyBatis / JPA / Prisma / TypeORM |
+| 测试框架 | 测试目录与配置 | JUnit5 / Vitest / Pytest |
+| Monorepo? | 顶层布局 | 单模块 / apps+packages |
+
+---
+
+## 2. 目录结构模板
+
+### Java + Spring Boot（模块化单体）
+
+```
+src/
+├── main/java/com/example/project/
+│   ├── common/                   # 公共工具
+│   │   ├── exception/            # 统一异常
+│   │   ├── response/             # 统一响应
+│   │   └── config/               # 全局配置
+│   ├── module1/                  # 业务模块
+│   │   ├── controller/
+│   │   ├── dto/
+│   │   │   ├── request/
+│   │   │   └── response/
+│   │   ├── application/          # 应用服务
+│   │   ├── domain/
+│   │   │   ├── entity/
+│   │   │   ├── vo/
+│   │   │   └── repository/       # 接口
+│   │   └── infrastructure/
+│   │       ├── repository/       # 实现
+│   │       └── mapper/           # MyBatis Mapper
+│   └── module2/
+│       └── ...
+├── main/resources/
+│   ├── application.yml
+│   ├── mapper/                   # MyBatis XML
+│   └── db/migration/             # 数据库迁移脚本
+└── test/java/com/example/project/
+    ├── module1/
+    │   ├── controller/           # Controller 测试
+    │   ├── application/          # Service 测试
+    │   └── domain/               # 领域逻辑测试
+    └── common/
+        └── BaseIntegrationTest.java
+```
+
+### TypeScript + NestJS（Monorepo）
+
+```
+apps/
+├── api/
+│   └── src/
+│       ├── modules/
+│       │   ├── module1/
+│       │   │   ├── module1.module.ts
+│       │   │   ├── module1.controller.ts
+│       │   │   ├── module1.service.ts
+│       │   │   ├── dto/
+│       │   │   ├── entities/
+│       │   │   └── __tests__/
+│       │   └── module2/
+│       ├── common/
+│       │   ├── filters/
+│       │   ├── guards/
+│       │   └── interceptors/
+│       └── main.ts
+packages/
+├── shared/
+│   └── src/
+│       ├── types/
+│       └── utils/
+```
+
+---
+
+## 3. 分层骨架生成规则
+
+### 从领域模型到代码的映射
+
+```mermaid
+graph LR
+    AGG["聚合根"] -->|"1:1"| ENTITY["Entity 类"]
+    VO_M["值对象"] -->|"1:1"| VO_C["Value Object 类"]
+    AGG -->|"1:1"| REPO_I["Repository 接口"]
+    REPO_I -->|"1:1"| REPO_IMPL["Repository 实现"]
+    DS["领域服务"] -->|"1:1"| DOMAIN_SVC["DomainService 类"]
+    UC["用例/用户故事"] -->|"1:1"| APP_SVC["ApplicationService 方法"]
+    AGG -->|"1:1"| CTRL["Controller 端点组"]
+
+    style AGG fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
+    style VO_M fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
+    style DS fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
+    style ENTITY fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
+    style VO_C fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
+    style REPO_I fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
+    style REPO_IMPL fill:#ffe0b2,stroke:#e65100,color:#bf360c
+    style DOMAIN_SVC fill:#e3f2fd,stroke:#1565c0,color:#0d47a1
+    style APP_SVC fill:#e8eaf6,stroke:#283593,color:#1a237e
+    style CTRL fill:#f5f5f5,stroke:#616161,color:#212121
+```
+
+### 各层职责与约束
+
+| 层级 | 职责 | 允许依赖 | 禁止依赖 |
+|--|--|--|--|
+| Controller | HTTP 入口、参数校验、DTO 转换 | Application 层 | Domain 直接操作 |
+| Application | 用例编排、事务控制 | Domain 层、Repository 接口 | Infrastructure 具体实现 |
+| Domain | 核心业务规则、不变量约束 | 仅自身（无外部依赖） | 任何框架注解 |
+| Infrastructure | 持久化实现、外部集成 | Domain 层(实现接口) | Controller / Application |
+
+---
+
+## 4. Entity 骨架生成
+
+每个聚合根生成以下内容：
+
+### Java 示例
+
+```java
+// domain/entity/MigrationTask.java
+public class MigrationTask {
+    private Long id;
+    private String name;
+    private TaskStatus status;
+    private LocalDateTime createdAt;
+    private LocalDateTime updatedAt;
+
+    // 领域行为（从用例提取）
+    public void start() {
+        if (this.status != TaskStatus.CONFIGURED) {
+            throw new TaskNotExecutableException(this.id);
+        }
+        this.status = TaskStatus.RUNNING;
+    }
+}
+```
+
+### TypeScript 示例
+
+```typescript
+// entities/migration-task.entity.ts
+export class MigrationTask {
+  constructor(
+    public readonly id: string,
+    public name: string,
+    public status: TaskStatus,
+    public readonly createdAt: Date,
+    public updatedAt: Date,
+  ) {}
+
+  start(): void {
+    if (this.status !== TaskStatus.CONFIGURED) {
+      throw new TaskNotExecutableError(this.id);
+    }
+    this.status = TaskStatus.RUNNING;
+  }
+}
+```
+
+### 生成要素
+- 从领域模型提取**所有字段**（属性名、类型、约束）
+- 从时序设计提取**领域行为方法**（方法签名 + 前置校验）
+- 值对象用不可变类/`readonly` 表达
+- 状态字段用枚举
+
+---
+
+## 5. Repository + Service 骨架
+
+### Repository 接口（领域层）
+
+```java
+public interface MigrationTaskRepository {
+    Optional<MigrationTask> findById(Long id);
+    List<MigrationTask> findByStatus(TaskStatus status);
+    MigrationTask save(MigrationTask task);
+    void deleteById(Long id);
+}
+```
+
+### ApplicationService（应用层）
+
+```java
+@Service
+@Transactional
+public class MigrationTaskAppService {
+
+    private final MigrationTaskRepository taskRepository;
+
+    // 从用例 US001~US008 提取方法
+    public MigrationTaskResponse createTask(CreateTaskCommand command) {
+        // TODO: 实现
+        throw new UnsupportedOperationException();
+    }
+
+    public void startTask(Long taskId) {
+        // TODO: 实现
+        throw new UnsupportedOperationException();
+    }
+}
+```
+
+### 生成原则
+- 每个 `TODO` 对应一个用户故事
+- Repository 方法从时序设计的数据库调用提取
+- Service 方法签名从时序设计的调用链提取
+- 骨架代码可编译但抛出 `UnsupportedOperationException`
+
+---
+
+## 6. 测试骨架
+
+### 测试配置
+
+```java
+// BaseIntegrationTest.java
+@SpringBootTest
+@Transactional
+@Rollback
+public abstract class BaseIntegrationTest {
+    // 集成测试基类，自动回滚
+}
+```
+
+### 单元测试骨架
+
+```java
+class MigrationTaskTest {
+
+    @Test
+    void should_start_task_when_status_is_configured() {
+        // TODO: 实现
+    }
+
+    @Test
+    void should_throw_when_starting_non_configured_task() {
+        // TODO: 实现
+    }
+}
+```
+
+### 生成原则
+- 每个 Entity 领域行为 → 至少 1 个正向 + 1 个异常测试骨架
+- 每个 Service 方法 → 1 个集成测试骨架
+- 测试命名：`should_[行为]_when_[条件]`
+
+---
+
+## 7. 输出清单
+
+| 制品 | 说明 |
+|--|--|
+| 项目目录结构 | 完整目录树，含 README |
+| 构建配置 | build.gradle / pom.xml / package.json |
+| Entity 类 | 所有聚合根 + 值对象 |
+| Repository 接口 + 实现 | 数据访问层 |
+| Service 骨架 | 所有用例对应的方法(TODO) |
+| Controller 骨架 | RESTful 端点 |
+| DTO 类 | Request + Response |
+| 测试骨架 | 单元测试 + 集成测试基类 |
+| 配置文件 | application.yml / .env |
+
+---
+
+## 参考
+
+详细模板与规则参见 `references/` 目录：
+- `scaffold-rules.md` — 各技术栈骨架生成详细规则与检查清单

package/skills/code-scaffold/references/scaffold-rules.md

@@ -0,0 +1,131 @@
+# 代码骨架生成规则与检查清单
+
+## 骨架生成顺序
+
+严格按以下顺序生成，确保依赖方向正确：
+
+1. **构建配置** — build.gradle / pom.xml / package.json
+2. **公共模块** — 统一异常、统一响应、全局配置
+3. **领域层** — Entity → Value Object → Repository 接口 → Domain Service
+4. **应用层** — Application Service（引用 Repository 接口）
+5. **基础设施层** — Repository 实现 → Mapper → 外部适配器
+6. **表现层** — Controller → DTO（Request/Response）
+7. **测试骨架** — 测试基类 → 单元测试 → 集成测试
+
+## 命名规范
+
+### Java / Spring Boot
+
+| 类型 | 后缀 | 包位置 |
+|--|--|--|
+| Controller | `XxxController` | `module/controller/` |
+| Application Service | `XxxAppService` | `module/application/` |
+| Domain Service | `XxxDomainService` | `module/domain/service/` |
+| Entity | `XxxEntity` 或直接领域名 | `module/domain/entity/` |
+| Value Object | `XxxVO` (领域) / `XxxVo` (DTO) | `module/domain/vo/` |
+| Repository 接口 | `XxxRepository` | `module/domain/repository/` |
+| Repository 实现 | `XxxRepositoryImpl` | `module/infrastructure/repository/` |
+| Mapper | `XxxMapper` | `module/infrastructure/mapper/` |
+| Request DTO | `XxxRequest` | `module/dto/request/` |
+| Response DTO | `XxxResponse` | `module/dto/response/` |
+
+### TypeScript / NestJS
+
+| 类型 | 命名 | 文件位置 |
+|--|--|--|
+| Controller | `xxx.controller.ts` | `modules/xxx/` |
+| Service | `xxx.service.ts` | `modules/xxx/` |
+| Entity | `xxx.entity.ts` | `modules/xxx/entities/` |
+| DTO | `create-xxx.dto.ts` | `modules/xxx/dto/` |
+| Repository | `xxx.repository.ts` | `modules/xxx/` |
+| Module | `xxx.module.ts` | `modules/xxx/` |
+| Test | `xxx.service.spec.ts` | `modules/xxx/__tests__/` |
+
+## 依赖注入规则
+
+### Spring Boot
+- 使用**构造器注入**（不用 `@Autowired` 字段注入）
+- 单个依赖可省略 `@Autowired`（Spring 4.3+）
+- 依赖 > 5 个时考虑拆分 Service
+
+### NestJS
+- 使用**构造器注入** + `@Injectable()`
+- 模块间通信通过 `exports` / `imports`
+
+## 构建配置模板
+
+### Gradle (Kotlin DSL)
+
+```kotlin
+plugins {
+    java
+    id("org.springframework.boot") version "3.x.x"
+    id("io.spring.dependency-management") version "1.x.x"
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+}
+
+dependencies {
+    // Web
+    implementation("org.springframework.boot:spring-boot-starter-web")
+    // Validation
+    implementation("org.springframework.boot:spring-boot-starter-validation")
+    // MyBatis
+    implementation("org.mybatis.spring.boot:mybatis-spring-boot-starter:3.x.x")
+    // Database
+    runtimeOnly("org.xerial:sqlite-jdbc")
+    // Test
+    testImplementation("org.springframework.boot:spring-boot-starter-test")
+}
+```
+
+### package.json (NestJS)
+
+```json
+{
+  "scripts": {
+    "build": "nest build",
+    "start:dev": "nest start --watch",
+    "test": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts"
+  }
+}
+```
+
+## 配置文件模板
+
+### application.yml
+
+```yaml
+spring:
+  application:
+    name: project-name
+  datasource:
+    url: jdbc:sqlite:data/app.db
+    driver-class-name: org.sqlite.JDBC
+
+mybatis:
+  mapper-locations: classpath:mapper/**/*.xml
+  configuration:
+    map-underscore-to-camel-case: true
+
+server:
+  port: 8080
+```
+
+## 骨架完成检查清单
+
+- [ ] 所有聚合根都有对应 Entity 类
+- [ ] 所有 Entity 都有 Repository 接口
+- [ ] 所有 Repository 接口都有 Implementation
+- [ ] 所有用例都有 ApplicationService 方法（可为 TODO）
+- [ ] 所有资源都有 Controller 端点
+- [ ] 所有端点都有 Request/Response DTO
+- [ ] 统一异常处理器已创建
+- [ ] 统一响应封装已创建
+- [ ] 构建配置完整，可编译通过
+- [ ] 测试框架已配置，样板测试可运行
+- [ ] 数据库迁移脚本目录已创建
+- [ ] 目录结构符合分层约束（无反向依赖）

package/skills/docs-output/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: docs-output
+description: >-
+  文档产出管理——维护项目 docs/ 目录的模块化组织和进度追踪。模块文档按业务维度分目录存放详细内容，进度记录按日期/会话hash存放摘要。支持多人协作和跨会话任务追溯，文件头部标识 Git 账号。被动调用，不会主动触发。
+  务必在以下场景使用本 skill：创建文档、文档目录管理、docs 目录、产出物管理、输出文档、document output、docs management、模块文档、文档分类、多人协作文档、跨会话文档、进度记录、任务摘要、progress、会话记录、开发日志。
+---
+
+# 文档产出管理
+
+本 Skill 解决两个核心问题：
+
+1. **文档产出缺乏统一组织**：模块文档散落、分类混乱
+2. **缺少任务进度记录**：模型处理需求/修复 Bug 后没有简要摘要，回溯困难
+
+本 Skill 管理 `docs/` 目录的两类内容：模块详细文档 + 进度摘要记录。
+
+## 数据模型
+
+```mermaid
+graph TD
+    TASK["模型执行任务<br/>需求分析 · Bug修复 · 技术方案"]
+    MODULES["docs/{module}/<br/>模块文档<br/>详细功能描述"]
+    PROGRESS["docs/progress/{date}/{hash}.md<br/>进度摘要<br/>会话级记录"]
+
+    TASK -->|"详细产出"| MODULES
+    TASK -->|"摘要记录"| PROGRESS
+
+    style TASK fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
+    style MODULES fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
+    style PROGRESS fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
+```
+
+## 原则
+
+- **被动调用**：本 skill 不会自动触发，仅在需要创建/管理文档或记录进度时被调用。
+- **模块化组织**：模块文档按业务维度分目录。
+- **一会话一文件**：进度记录按日期/会话hash独立存放，多人不冲突。
+- **只管结构不管内容格式**：文档内容格式由调用方决定。
+- **Git 账号标识**：进度记录头部包含开发者 Git 账号。
+
+## 目录结构
+
+```
+docs/
+├── auth/                              # 业务模块 — 详细文档
+│   ├── login.md
+│   └── register.md
+├── user/
+│   ├── profile.md
+│   └── settings.md
+├── progress/                          # 进度记录
+│   ├── 2024-01-15/
+│   │   ├── a3f8c1.md                  # 会话hash
+│   │   └── b7d2e4.md
+│   ├── 2024-01-16/
+│   │   └── c9e5f0.md
+│   └── archive/                       # 归档（>30天）
+│       └── 2024-01/
+│           └── ...
+```
+
+### 模块文档规则
+
+- 一级目录 = 业务模块（如 `auth`、`user`、`dashboard`）
+- 二级文件 = 页面/功能点（如 `login.md`、`register.md`）
+- 模块名和文件名使用 kebab-case
+- 中文项目可用中文命名
+
+### 进度记录规则
+
+- 路径：`docs/progress/{YYYY-MM-DD}/{会话hash}.md`
+- 会话hash：6位随机十六进制（如 `a3f8c1`），保证唯一
+- 同一天可有多个会话文件（不同人/不同任务）
+
+> 完整命名规则见 → `references/naming-rules.md`
+
+## 进度记录模板
+
+```markdown
+# {主题}
+
+- **日期**: YYYY-MM-DD
+- **开发者**: {git user.name} <{git user.email}>
+- **类型**: 需求开发 | Bug修复 | 技术方案 | 重构 | 其他
+
+## 任务摘要
+
+（一两句话描述本次会话完成了什么）
+
+## 变更文件
+
+- `path/to/file1.ts` — 修改原因
+
+## 决策记录
+
+（简要记录重要的技术决策）
+
+## 遗留问题
+
+（未完成的事项或待跟进的问题）
+```
+
+## 核心能力（被动 API）
+
+### 1. create — 创建模块文档
+
+在指定模块目录下创建新文档。
+
+- 自动创建模块目录（如不存在）
+- 生成空白文档（仅包含一级标题）
+
+### 2. progress — 记录进度
+
+创建一份会话进度摘要。
+
+- 自动获取 Git 账号信息
+- 生成日期目录和会话hash文件
+- 填充进度模板
+
+### 3. list — 列出文档
+
+按模块和进度分别列出 docs/ 下所有内容。
+
+### 4. validate — 校验目录
+
+检查文档目录的基本健康状态。
+
+### 5. archive — 归档旧进度
+
+将超过 30 天的进度记录移入 `progress/archive/YYYY-MM/`。
+
+## 多人协作
+
+- **模块粒度隔离**：不同开发者负责不同模块目录，天然避免文件冲突
+- **进度无冲突**：每个会话独立文件（日期+hash），多人同时工作不会冲突
+- **分支工作流**：每人在独立 Git 分支上工作，通过 PR 合入
+- **Git 账号追溯**：进度记录头部包含 `git user.name` 和 `git user.email`，可追溯到具体开发者
+
+## Python 脚本
+
+```bash
+python scripts/docs_manager.py create   --root <project_root> --module <模块名> --name <文档名> [--title <一级标题>]
+python scripts/docs_manager.py progress --root <project_root> --topic <主题> --type <类型> --summary <摘要> [--files <变更文件JSON>] [--decisions <决策>] [--todos <遗留>]
+python scripts/docs_manager.py list     --root <project_root>
+python scripts/docs_manager.py validate --root <project_root>
+python scripts/docs_manager.py archive  --root <project_root> [--older-than <天数>]
+```
+
+> 输出均为 JSON 格式，便于模型解析。

package/skills/docs-output/references/naming-rules.md

@@ -0,0 +1,52 @@
+# 文档命名与组织规则
+
+## 目录结构
+
+```
+docs/
+├── auth/                       # 认证模块
+│   ├── login.md
+│   └── register.md
+├── user/                       # 用户模块
+│   ├── profile.md
+│   └── settings.md
+├── order/                      # 订单模块
+│   ├── create-order.md
+│   ├── order-list.md
+│   └── order-detail.md
+├── dashboard/                  # 仪表盘模块
+│   └── overview.md
+└── progress/                   # 进度记录
+    ├── 2025-01-15/
+    │   ├── a3f2c1.md
+    │   └── b7e4d9.md
+    ├── 2025-01-16/
+    │   └── c8a1f0.md
+    └── archive/                # 归档（>30天自动迁移）
+        └── 2024-12/
+            └── 2024-12-10/
+                └── d1e2f3.md
+```
+
+## 命名规范
+
+| 层级 | 规则 | 示例 |
+|------|------|------|
+| 一级目录 | 业务模块名，kebab-case | `auth`、`user`、`order-management` |
+| 二级文件 | 页面/功能点名，kebab-case，`.md` 扩展名 | `login.md`、`create-order.md` |
+| 进度日期目录 | `YYYY-MM-DD` 格式 | `2025-01-15` |
+| 进度文件 | 6 位十六进制会话 hash | `a3f2c1.md` |
+| 归档月度目录 | `YYYY-MM` 格式 | `2024-12` |
+
+## 详细规则
+
+1. **模块目录**：名称简短，2-4 个词，使用 kebab-case（如 `user-management`，不用 `userManagement`）
+2. **功能文件**：名称对应具体页面或功能点，使用 kebab-case
+3. **中文名允许**：如果项目统一使用中文，模块和文件名可用中文（如 `认证/登录.md`）
+4. **不使用序号前缀**：模块化结构不需要 `01-`、`02-` 编号
+
+## 多人协作约定
+
+- 开发前明确模块归属，每人负责不同模块目录
+- 一个功能点 = 一个 `.md` 文件，避免多人编辑同一文件
+- 在独立 Git 分支上工作，通过 PR 合入主分支