# jed-devflow

**Repository Path**: jfeng-studio/jed-devflow

## Basic Information

- **Project Name**: jed-devflow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# jed DevFlow

jed 开发工作流体系，基于 Claude Code Skills 的 AI 研发协同框架。

核心定位：工作流驱动，角色/专家/规范挂在工作流上，覆盖从需求提案到制品发布的完整软件工程链路。96 个 Skill（13 workflows + 5 roles + 31 devs + 19 experts + 24 standards + 4 utils），适用于单语言项目到跨语言复杂系统（C/C++/C#/Rust/Go/TS/Py + 嵌入式/微服务/桌面/Web/仿真/WASM）。

基底工具：OpenSpec 管需求生命周期，Superpowers 管实现侧增强（TDD/代码审查）。

## Skill 文件标准

当前仓库采用的规则是：

- 保留 `jed-devflow/skills/` 作为全局 Skill 根目录
- 保留原来的分类子目录结构，如 `workflows`、`roles`、`devs`、`experts`、`standards`、`utils`
- 每个 Skill 不再是单个 `xxx.md` 文件
- 每个 Skill 改为 `技能名/SKILL.md` 的目录形式

标准路径：

```text
skills/<group>/<skill-name>/SKILL.md
```

`SKILL.md` 建议统一包含 frontmatter：

```md
---
name: "jed-init"
description: "Initializes a project for jed-devflow. Invoke when starting a new project and needing local config, memory, changelog, and OpenSpec scaffolding."
---
```

其中 `description` 要同时说明两件事：

- 这个 Skill 做什么
- 什么时候调用它

## 目录结构

### 全局（`jed-devflow/`）

```text
jed-devflow/
├── plugin.json
├── README.md
└── skills/
    ├── workflows/
    │   ├── jed-init/
    │   │   └── SKILL.md
    │   ├── jed-onboard/
    │   │   └── SKILL.md
    │   ├── jed-proposal/
    │   │   └── SKILL.md
    │   └── ...
    ├── roles/
    │   ├── jed-pm/
    │   │   └── SKILL.md
    │   ├── jed-architect/
    │   │   └── SKILL.md
    │   └── ...
    ├── devs/
    │   ├── jed-dev-cs-webapi/
    │   │   └── SKILL.md
    │   └── ...
    ├── experts/
    │   ├── foundational/
    │   │   ├── expert-mathematics/
    │   │   │   └── SKILL.md
    │   │   └── ...
    │   ├── domain/
    │   ├── infra/
    │   └── industry/
    ├── standards/
    │   ├── jed-ts-style/
    │   │   └── SKILL.md
    │   ├── jed-changelog-style/
    │   │   └── SKILL.md
    │   └── ...
    └── utils/
        ├── jed-project-scanner/
        │   └── SKILL.md
        └── ...
```

- `plugin.json`：插件描述文件，定义插件名称、版本、兼容性与 Skill 根目录。
- `README.md`：总说明文档，介绍目录结构、命名规则、工作流链路与各类 Skill 的职责。
- `skills/workflows/`：核心工作流集合，负责驱动从初始化、提案、设计、实现到归档、发布、排障的完整流程。
- `skills/roles/`：职能角色集合，提供 PM、架构、评审、QA、DevOps 等视角补充。
- `skills/devs/`：按语言与项目类型细分的开发角色集合，用于在实现阶段按 Assign 加载对应开发能力。
- `skills/experts/`：领域专家集合，覆盖基础科学、垂直领域、基础设施与行业业务等咨询能力。
- `skills/standards/`：规范类 Skill 集合，定义代码、文档、提交、CHANGELOG、UX/UI 等统一标准。
- `skills/utils/`：辅助工具 Skill 集合，用于扫描项目结构、检查依赖与估算上下文成本。

### 项目级（`.claude/skills/` + 约定目录）

项目根 `.claude/skills/` 下仅放 `local-config` 一个 Skill，也改为目录式结构：

```text
<project-root>/
└── .claude/
    └── skills/
        └── local-config/
            └── SKILL.md
```

`local-config` 由 `/jed:init` 或 `/jed:onboard` 生成，手动可改，用于本项目的 scope、记忆库路径、CHANGELOG 轨映射、默认 Assign、Superpowers 开关。

约定目录（全局 workflow 写死引用，项目级不可改）：
- `project_memory/`：项目根固定，单文件簇 + `INDEX.md` 导航
- `specs/active/`：OpenSpec 需求草稿目录

项目常规目录（非 jed-devflow 强管，列出供参考）：
- `docs/pm/`：项目管理文档目录，包含立项书、需求规格、概要设计、详细设计、项目计划、质量计划、变更日志 7 个 PM 文档
- `src/CHANGELOG.md`：多轨 CHANGELOG 之一
- `demo/CHANGELOG.md`：多轨 CHANGELOG 之二
- `tests/`：自动化测试
- `obsidian-vault/`：可选，跨项目知识库，路径由 `local-config` 配置

## 分类与命名

命令空间：
- `/jed:`：统一命名空间。workflow 无前缀（`/jed:init`），角色 `role:` 前缀（`/jed:role:pm`），专家 `exp:` 前缀（`/jed:exp:db`）。dev 角色由 workflow 自动加载不暴露。
- `/expert:`：**已废弃，改用 `/jed:exp:`**

## 斜杠指令速查

| 类别 | 指令示例 | 用途 |
|------|---------|------|
| **项目初始化** | `/jed:list` | 列出全部命令 |
| | `/jed:init` | 新项目初始化 |
| | `/jed:onboard` | 旧项目接入 |
| **需求链** | `/jed:proposal` | 交互式需求澄清 |
| | `/jed:design` | 技术设计（HLD+LLD+tasks） |
| | `/jed:revert` | 回退已归档需求 |
| **开发链** | `/jed:implement` | 编码执行（TDD 批量推进） |
| | `/jed:test` | 测试验证 |
| | `/jed:review` | 代码审查 |
| | `/jed:integrate` | 多模块集成联调 |
| **收尾链** | `/jed:archive` | 归档收尾 |
| | `/jed:distill` | 知识蒸馏到 project_memory |
| | `/jed:release` | 正式发布（SemVer+Tag） |
| **运维** | `/jed:triage` | 缺陷诊断排查 |
| **角色咨询** | `/jed:role:pm` | 产品经理视角 |
| | `/jed:role:architect` | 架构师视角 |
| | `/jed:role:reviewer` | 评审者视角 |
| | `/jed:role:qa` | 质量保障视角 |
| | `/jed:role:devops` | DevOps 视角 |
| **领域专家** | `/jed:exp:db` | 数据库设计咨询 |
| | `/jed:exp:embedded` | 嵌入式系统咨询 |
| | `/jed:exp:uav` | 无人机领域咨询 |
| | `/jed:exp:sim` | 三维仿真/图形学咨询 |
| | `/jed:exp:gpu` | GPU 加速运算咨询 |
| | `/jed:exp:net` | 网络协议深度咨询 |
| | `/jed:exp:mfg` | 制造业/工业咨询 |
| | `/jed:exp:med` | 医疗健康咨询 |
| | `/jed:exp:crypto` | 加密与安全咨询 |
| | `/jed:exp:dist` | 分布式系统咨询 |
| | `/jed:exp:cache` | 缓存策略咨询 |
| | `/jed:exp:container` | 容器编排咨询 |
| | `/jed:exp:mqtt` | MQTT 物联网咨询 |
| | `/jed:exp:finance` | 金融领域咨询 |
| | `/jed:exp:psy` | 认知心理学咨询 |
| | `/jed:exp:uxui` | UI/UX 设计咨询 |
| | `/jed:exp:math` | 数学/数值计算咨询 |
| | `/jed:exp:physics` | 物理/控制理论咨询 |
| | `/jed:exp:ai` | AI/ML 理论咨询 |

dev 角色由 workflow 自动加载，不暴露为斜杠命令。

专家用户手动调用格式：`/jed:exp:<领域>`，可单独发起专业知识对话。

文件映射示例：
- `jed-init` → `skills/workflows/jed-init/SKILL.md`
- `jed-role-pm` → `skills/roles/jed-pm/SKILL.md`
- `jed-exp-crypto` → `skills/experts/domain/expert-crypto/SKILL.md`

开发角色命名：`jed-dev-<主语言>-<项目类型>`，使用 kebab-case
- `jed-dev-cs-webapi` → C# + ASP.NET Core WebAPI
- `jed-dev-rust-cli` → Rust 跨平台 CLI
- `jed-dev-arduino-esp32` → ESP32 + Arduino 框架

专家命名：`jed:exp:<领域>`，分 foundational / domain / infra / industry 四层。由 workflow 按需自动调用，也可用户手动 `/jed:exp:xxx` 咨询。

## 当前 Skill 分组

`workflows`
- `jed-init`：新项目初始化，创建 Git、README、CLAUDE、local-config、project_memory、CHANGELOG 与 OpenSpec 骨架。
- `jed-onboard`：旧项目接入，扫描现有结构并兼容已有配置、CHANGELOG 与需求资产。
- `jed-proposal`：需求提案阶段，沉淀问题定义、目标、范围与 OpenSpec 草稿。
- `jed-design`：交互式技术设计器，从 proposal 的 spec 接续，通过结构化交互确认产出 HLD（架构/模块/技术栈/ADR）+ LLD（接口签名/数据模型/关键流程，按复杂度分级深度）+ tasks（粒度由 LLD 决定）+ PM 文档更新（概要设计/详细设计/项目计划/质量计划）。复杂度三级：完整设计（新模块/跨模块，方法级 task）、轻量设计（单模块新增，类级 task）、微变更（修 bug/改文案，描述级 task）。Expert 自动匹配 + 用户显式指定。用户确认前禁止生成制品。
- `jed-implement`：编码执行器，按 task 依赖顺序批量推进。严格按 design.md 的接口签名/数据模型/技术栈编码，强制 TDD（红→绿→重构→提交），偏离设计时停止问用户，编译错误 3 次上限后交由用户处理，每 task 在 tasks.md 勾选 `[x]`，全部完成后代码自查 + 告知准备下一阶段。
- `jed-test`：测试执行器。implement 后执行本轮变更相关测试，策略来自质量计划（design 阶段 qa 已定义），执行三层测试（单元/集成/E2E）并对照 spec 验收标准。未通过提供三选项（自动修复/手动修复/忽略继续），不自动改代码。
- `jed-review`：代码审查器。test 通过后审查全部实现产物，7 维审查（设计一致性/语义/风格/测试覆盖/容器/UI/提交历史），P1/P2/P3 三级严重程度，输出通过/有条件通过/不通过三类结果。不通过退回 implement，不改代码。
- `jed-integrate`：集成联调器。review 后验证多模块拼装/接口对齐/环境联通，单模块项目自动跳过。发现问题三选项（退回 implement/记录遗留/手动处理），不改代码。
- `jed-archive`：阶段收尾，完成需求同步、OpenSpec 归档、记忆库更新、文档更新与 CHANGELOG 整理。完成后询问是否执行 distill 蒸馏。
- `jed-distill`：知识蒸馏器，从已归档 spec 提取决策/踩坑/约束到 project_memory，完成后删除 spec 残留。自动跳过无蒸馏价值的 spec。
- `jed-release`：发布执行器。archive 完成后按 Git 惯例执行 7 步（SemVer 版本判定→更新版本文件→CHANGELOG Unreleased 封版→Git Tag→发布说明→提交建议→制品交付）。不自动 commit/push。
- `jed-triage`：缺陷排查器。定位问题 → 收集证据 → 检索记忆 → 收敛假设 → 判定修复路径（需求/设计/实现/环境/微变更快速通道 5 层），回链对应 workflow。不改代码。
- `jed-revert`：回退执行器。撤销需求 → 评估波及 → 回退 spec 为 REMOVED → 同步 PM 文档 → 写入 CHANGELOG。与 proposal 对称。

`roles`
- `jed-role-pm`（`/jed:role:pm`）：产品经理视角，负责目标澄清、范围控制、需求表达与业务价值判断。主编 PM 文档：立项书、需求规格、项目计划、变更日志。
- `jed-role-architect`（`/jed:role:architect`）：架构师视角，负责系统边界、目录结构、模块职责与关键技术决策。主编 PM 文档：概要设计、详细设计。
- `jed-role-reviewer`（`/jed:role:reviewer`）：评审者视角，负责代码质量、实现风险、规范遵循与回归风险审查。不主编 PM 文档，引用 PM 文档规范做校验。
- `jed-role-qa`（`/jed:role:qa`）：质量保障视角，负责质量计划编写、测试策略设计、验证闭环与发布条件判定。主编 PM 文档：质量计划。
- `jed-role-devops`（`/jed:role:devops`）：DevOps 视角，提供 CI/CD 流水线、构建、制品、容器与交付能力。参与项目计划的环境排期与质量计划的 CI/CD 采集。

`devs`
- `jed-dev-c-embedded`：C 嵌入式/单片机场景开发角色。
- `jed-dev-c-cli`：C 控制台程序开发角色。
- `jed-dev-cpp-qt`：C++ Qt 跨平台桌面开发角色。
- `jed-dev-cpp-dll`：C++ Windows DLL 开发角色。
- `jed-dev-cpp-windows`：C++ 原生 Windows 桌面开发角色。
- `jed-dev-rust-system`：Rust 系统级程序开发角色。
- `jed-dev-rust-cli`：Rust 跨平台 CLI 开发角色。
- `jed-dev-rust-webapi`：Rust WebAPI 开发角色，适用于 axum/tonic 等后端服务。
- `jed-dev-cs-wpf`：C# WPF 桌面应用开发角色。
- `jed-dev-cs-winui3`：C# WinUI 3 桌面应用开发角色。
- `jed-dev-cs-webapi`：C# ASP.NET Core WebAPI 开发角色。
- `jed-dev-cs-cli`：C# .NET CLI 工具开发角色。
- `jed-dev-go-microservice`：Go 微服务开发角色，面向 gRPC、分布式与服务治理场景。
- `jed-dev-go-cli`：Go CLI 工具开发角色。
- `jed-dev-ts-vue`：TS + Vue / Vite / Electron 渲染层开发角色。
- `jed-dev-ts-electron-main`：TS Electron 主进程开发角色。
- `jed-dev-node-webapi`：Node.js WebAPI 开发角色。
- `jed-dev-js-script`：纯 JavaScript 脚本开发角色。
- `jed-dev-py-script`：Python 脚本、自动化与 AI 工具开发角色。
- `jed-dev-py-data`：Python 数据处理与数据库相关开发角色。
- `jed-dev-test-py-pytest`：Python Pytest 测试开发角色。
- `jed-dev-test-cs-xunit`：C# xUnit 测试开发角色。
- `jed-dev-test-cpp-gtest`：C++ GoogleTest 测试开发角色。
- `jed-dev-uav-firmware`：无人机固件开发角色，偏飞控与实时系统。
- `jed-dev-arduino-esp32`：ESP32 Arduino 开发角色，面向 WiFi/BLE/GPIO。
- `jed-dev-c-raspberry`：树莓派 C + Python GPIO 场景开发角色。
- `jed-dev-rust-wasm`：Rust WebAssembly 开发角色（wasm-pack + wasm-bindgen + web-sys）。
- `jed-dev-cpp-wasm`：C++ WebAssembly 开发角色（Emscripten + CMake）。
- `jed-dev-cs-wasm`：C# WebAssembly 开发角色（.NET wasm / Uno Platform）。
- `jed-dev-rust-embedded`：Rust 嵌入式开发角色（no_std + embedded-hal + embassy + probe-rs）。
- `jed-dev-rust-bevy`：Rust 桌面/游戏/仿真开发角色（bevy ECS + wgpu 渲染）。

`experts/foundational`
- `expert-mathematics`：数学专家，用于算法、建模、数值分析与推导校验。
- `expert-physics`：物理专家，用于与运动学、动力学、信号或物理约束相关的问题。
- `expert-ai-theory`：AI 理论专家，用于模型原理、学习框架与推理机制分析。

`experts/domain`
- `expert-uav`：无人机领域专家，覆盖飞控业务、任务链路与领域约束。
- `expert-psychology`：认知/行为心理专家，辅助设计评审、交互理解与用户行为分析。
- `expert-finance`：金融领域专家，用于金融流程、术语、约束与风险分析。
- `expert-crypto`：密码学专家，用于加密、签名、密钥、协议与安全设计判断。
- `expert-distributed`：分布式系统专家，用于一致性、CAP、容错与分布式架构问题。
- `expert-uxui`：UI/UX 设计专家，提供设计心理学（菲茨/希克/米勒/格式塔/雅各布定律）、视觉层次（CRAP 原则）、交互模式（导航/表单/反馈/错误处理/搜索）、可访问性深度（WCAG 2.2 AA、ARIA 模式、键盘交互、屏幕阅读器、认知可访问性）、设计系统建设（三层 token、Atomic Design、模式库、版本化）、响应式策略（移动优先、断点、内容优先级）、信息架构（卡片分类、导航深度、标签系统）、微交互（触发-规则-反馈-循环）、视觉理论（色彩/排版/构图/平衡）九大能力，含反模式与决策模板，被 `jed-architect` 在 scope 含 UI 时联动（正向设计），与 `expert-psychology`（反向审查）互补。
- `expert-simulation`：三维仿真领域专家，覆盖计算机图形学（渲染管线/PBR/阴影/光线追踪）、物理引擎（刚体/柔体/流体/粒子）、骨骼动画与蒙皮、IK（CCD/FABRIK）、图形 API 与引擎选型（Vulkan/DirectX/Metal/WebGPU/Unreal/Unity/bevy/Three.js/Babylon.js）。
- `expert-gpu`：GPU 加速运算领域专家，覆盖 CUDA/OpenCL/Vulkan Compute/WebGPU Compute、并行算法（Reduction/Scan/Sort/GEMM/FFT）、内存优化（合并访问/Bank Conflict/Occupancy）、性能分析工具。

`experts/infra`
- `expert-db`：数据库专家，用于关系型/非关系型数据库设计、查询与存储策略。
- `expert-mqtt`：MQTT 专家，用于消息主题、QoS、连接管理与物联网通信场景。
- `expert-cache`：缓存专家，用于 Redis 等缓存系统设计与一致性权衡。
- `expert-embedded`：嵌入式专家，用于 GPIO、I2C、SPI、RTOS 与硬件交互问题。
- `expert-container`：容器专家，用于 Docker/Podman 镜像、运行时与交付问题。
- `expert-network`：网络协议深度专家，覆盖 HTTP/2（Multiplexing/HPACK/Server Push）、HTTP/3（QUIC/0-RTT/Connection Migration）、gRPC（Protobuf/Streaming/Deadline/Cancellation）、WebSocket（Upgrade/Masking/Ping-Pong/反压/重连）。

`experts/industry`
- `expert-manufacturing`：制造与工业领域专家。覆盖 ISA-95 工业自动化层次（L0-L4）、工业协议（OPC-UA/Modbus/EtherCAT 选型+对比）、数字孪生三层能力（监控/预测/模拟）、OT 安全 vs IT 安全（Purdue 模型/IEC 62443 安全等级）、智能制造（IIoT/AI 质量检测/预测性维护/APS）、常见生产环境陷阱。
- `expert-medical`：医疗健康领域专家。覆盖 IEC 62304 软件安全分类（A/B/C 三级后果+要求）、医疗互操作标准（DICOM/HL7 v2/FHIR 选型速查+陷阱）、法规合规（FDA 510(k)/De Novo/PMA/SaMD + MDR/ISO 13485）、HIPAA/GDPR 数据隐私（PHI 加密+审计日志+去标识化）、医学影像 AI（CADe/CADx+数据漂移+可解释性+标注成本）。

`standards`
- `jed-c-style`：C 代码风格规范（MISRA-C 子集 + 嵌入式场景）。snake_case 命名（函数/变量 + `g_` 全局前缀 + `_t` 类型后缀 + `_e` 枚举后缀 + UPPER_SNAKE_CASE 宏）、`#ifndef` include guard + `extern "C"` + opaque type 消息隐藏 + `_private.h` 内部头文件、include 3 组顺序（对应头/标准库/项目）、clang-format（LLVM 基/4 空格/100 行宽/Allman 大括号/指针右对齐）、cppcheck `--enable=all --error-exitcode=1` + `-Wall -Wextra -Werror`、Doxygen 文档注释（`@brief`/`@param`/`@return` + 所有权/空指针行为/线程安全）、goto cleanup 错误处理（返回值错误码 + 逆序 LIFO 释放 + 指针初始化为 NULL + `free(NULL)`/`fclose(NULL)` 安全）、NULL 检查（公共函数防御性 + 内部函数 assert）、`stdint.h` 明确宽度 + 整型溢出检查 + `_Static_assert`、opaque type 信息隐藏 + C99 指定初始化器 + 多语句宏 `do-while(0)`、Unity/Ceedling 测试（`test_<Module>_<Function>_<Scenario>` + setUp/tearDown）+ 覆盖率 ≥ 60%（嵌入式）/ ≥ 70%（主机）、CMake C11 标准 + Makefile（嵌入式）、C 专属（嵌入式固定大小缓冲区 vs 动态分配 + RTOS FreeRTOS 并发保护 + MISRA-C:2012 关键规则子集 + 内存所有权文档（_create/_alloc → _free/_destroy））。被 `jed-dev-c` 引用。
- `jed-cpp-style`：C++ 代码风格规范。C++ Core Guidelines 命名（PascalCase 类/函数、snake_case 变量、`snake_case_` 成员后缀、kPascalCase/UPPER_SNAKE_CASE 常量）、CMake src/ + `#pragma once` + include 5 组、clang-format（Google 基/4 空格/120 行宽/Attach 大括号）+ clang-tidy `-warnings-as-errors`（cppcoreguidelines/modernize/readability）+ cppcheck + iwyu、Doxygen 文档注释（`@brief`/`@param`/`@return`/`@throws`）、RAII 资源管理 + 智能指针（`unique_ptr` 默认/`shared_ptr` 共享、禁裸 new/delete）、异常优先（自定义异常层级）+ `std::optional`/`std::expected` + `noexcept`、const 正确性 + 值语义 + 移动语义（`std::move`）+ Rule of Zero/Five、`enum class` PascalCase、C++20 概念 + `string_view`/`span` + 结构化绑定、GoogleTest + GoogleMock（夹具 + AAA + `ClassName_MethodName_Scenario`）+ 覆盖率 ≥ 70%、CMake 3.20+ + vcpkg/Conan + `compile_commands.json`、C++ 专属（spdlog 结构化日志、`std::jthread`/`std::async`、`std::shared_mutex` 读写锁、`emplace_back`/`reserve` 预分配、`[[nodiscard]]`）。被 `jed-dev-cpp` 引用。
- `jed-cs-style`：C# 代码风格规范。Microsoft 命名（PascalCase 公共/接口/方法/属性 + `_camelCase` 私有字段 + `I` 接口前缀 + `Async` 异步方法后缀 + 构造函数 `new`/`Create`/`From`）、.sln 多项目结构（WebApi/Application/Domain/Infrastructure）、文件范围命名空间（C# 10+）+ 全局 using、.editorconfig（4 空格 + 120 行宽 + Allman 大括号 + 显式访问修饰符）+ dotnet format + Roslyn Analyzers（/warnaserror）、XML 文档注释（`<summary>`/`<param>`/`<returns>`/`<exception>`）、2 组 using（System → 其他、禁全限定名）、异常层级（AppException 基类 + NotFoundException/ValidationException + 全局异常中间件 + Result 模式可选）、record 优先（DTO 不可变 `init`）+ 主构造 DI（C# 12）+ 枚举从 1 + 模式匹配（switch 表达式/is/property pattern）+ LINQ 声明式查询 + 集合表达式、构造函数注入（禁 Service Locator）+ Nullable 启用 + async/await + CancellationToken, xUnit + Moq + FluentAssertions + AAA + 覆盖率 ≥ 70%、Directory.Packages.props 集中版本 + NuGet + `net8.0`、C# 专属（DI 注册生命周期 + Web API 控制器 + Options 模式配置 + ILogger<T 结构化日志 + 优雅停机 IHostApplicationLifetime + HttpClientFactory + Span<T/ArrayPool<T）。被 `jed-dev-cs` 引用。
- `jed-go-style`：Go 代码风格规范。Effective Go 命名（短名 + 驼峰 + 首字母控制可见性 + `-er` 接口后缀 + 不用 this/self + Getter 不用 Get 前缀）、Standard Go Project Layout（`cmd/` 入口 + `internal/` 私有 + `pkg/` 公共）、gofmt + goimports + golangci-lint（errcheck/govet/staticcheck/gosec/errorlint/contextcheck/bodyclose）、godoc 注释（导出标识符 + 包注释）、3 组导入顺序、错误值哲学（`errors.Is`/`As` + `%w` 包装 + sentinel + 自定义错误类型 + `errors.Join` + panic 仅不可恢复）、小接口（消费方定义，1-3 方法）、类型定义优于别名、iota 从 1 开始、零值可用、`ctx context.Context` 第一参数、table-driven 测试（testify/assert + require + mockery + t.Cleanup）、覆盖率 ≥ 70%、go mod（`go.mod`/`go.sum` 必提交 + `go mod tidy` + 语义化版本）、Go 专属（goroutine + channel 优先于锁 + 不泄漏、slog 结构化日志、优雅停机 SIGTERM/SIGINT、`strings.Builder`/`sync.Pool`/pprof）。被 `jed-dev-go` 引用。
- `jed-rust-style`：Rust 代码风格规范。RFC 430 命名（snake_case 函数/变量/模块、PascalCase 类型/Trait/枚举变体、UPPER_SNAKE_CASE 常量、Getter 不用 get 前缀、构造函数 `new`/`with_xxx`/`from_xxx`）、src/ 结构 + 2018+ 模块风格（不用 `mod.rs`）、默认私有 + `pub use` 重导出、3 组 use 导入（标准库/第三方/`crate::`）、rustfmt（4 空格 + 100 行宽 + 末尾逗号）、clippy `-D warnings`（禁 `unwrap`/`expect`/`panic!`/`dbg!`/`println!`）、rustdoc 文档注释（`///` 公共项 + `//!` 模块注释 + `# Errors`/`# Examples`）、禁通配导入（除 prelude/测试）、`Result<T, E>` + `?` 操作符 + `thiserror`（库）/ `anyhow`（应用）+ `context` 附加上下文 + `panic!` 仅不可恢复 + 自定义 `Result` 类型别名、所有权优先（默认借用 `&T`/`&mut T`，不滥用 `clone`）、小 Trait（1-5 方法，单一职责）、`Send + Sync` 跨线程标注、`struct` + `enum`（不用继承）+ `#[derive]`、Newtype 模式防类型混淆、避免不必要生命周期（默认 `String` 拥有）、async/await + tokio 运行时、`#[tokio::test]` 异步测试 + `mockall` 生成 Mock + `proptest` 属性测试 + 覆盖率 ≥ 70% + 文档测试、cargo + workspace（多 crate 统一版本）+ `Cargo.lock` 二进制必提交 + `cargo-audit` 安全扫描、Rust 专属（`Arc` 跨线程共享 + `RwLock`/`Mutex` 内部可变性 + `tracing` 结构化日志 + `#[instrument]` + axum Web 框架 + 优雅停机 SIGTERM/SIGINT + `unsafe` 隔离 + `// SAFETY:` 注释 + `Cow`/`SmallVec` 性能优化）。被 `jed-dev-rust` 引用。
- `jed-ts-style`：TypeScript 代码风格规范。10 段标准结构（命名 / 文件组织 / 格式化 / Lint 工具 / 注释 / 导入 / 错误处理 / 类型规范 / 测试 / 依赖管理），ESM 优先、避免 `any` 用 `unknown`、联合字面量优于枚举、严格 tsconfig、Vitest + Co-locate、pnpm + lock 文件必提交。作为代码风格统一模板的示范，被 `jed-dev-ts-vue` / `jed-dev-node` / `jed-dev-react` / `jed-dev-fullstack` 引用。
- `jed-node-style`：Node.js 服务端风格规范。在 `jed-ts-style` 基础上叠加 Node 专属规则：ESM 优先 + `node:` 前缀导入、Node LTS、分层架构 Controller→Service→Repository、AppError 错误类层级（含 statusCode/code）、async/await 优先、pipeline 优于 pipe、`Buffer.from`/`alloc`、EventEmitter 监听 error、`execFile` 优于 `exec`（防 shell 注入）、Pino 结构化日志禁 `console.log`、Zod 校验环境变量、优雅停机（SIGTERM/SIGINT）。被 `jed-dev-node` / `jed-dev-fullstack` 引用。
- `jed-vue-style`：Vue 3 项目风格规范。在 `jed-ts-style` 基础上叠加 Vue SFC 专属规则：强制 `<script setup lang="ts">` 组合式 API、SFC 块顺序 template→script→style、Props/Emit 类型声明（不用运行时声明）、禁止 mutating props、v-model 用 modelValue、scoped 样式 + CSS 变量引用设计 token、Pinia setup store、Vue Router 懒加载 + 集中守卫、`vue-tsc` 类型检查、指令缩写（`:`/`@`/`#`）。被 `jed-dev-ts-vue` / `jed-dev-fullstack` 引用。
- `jed-py-style`：Python 代码风格规范。PEP 8 命名/格式化（snake_case 变量、PascalCase 类、4 空格、100 字符行宽）、Ruff（lint + format 替代 Black/isort/Flake8）+ mypy strict、类型注解强制（所有函数签名）、Python 3.10+ 新语法（`|` 联合、`list[]`、`asyncio.TaskGroup`）、`from __future__ import annotations`、Pydantic v2（API 边界）+ dataclass `frozen=True`/`slots=True`（内部）+ Protocol（接口）+ 禁用 Any、AppError 异常类层级 + `from` 保留异常链 + 不裸 except、src layout、pytest + AAA + 覆盖率 ≥ 80%、uv 依赖管理。被 `jed-dev-py` / `jed-dev-ai` 引用。
- `jed-arduino-style`：Arduino/ESP32 代码风格规范（嵌入式 C++ 受限子集）。PascalCase/camelCase 函数 + camelCase 变量 + UPPER_SNAKE_CASE 常量/引脚 + `g_` 全局前缀 + `constexpr uint8_t` 引脚定义 + `config.h` 集中配置、PlatformIO 项目结构（`src/`/`include/`/`lib/`/`test/`/`data/`）+ `main.cpp` 入口（不用 `.ino`）+ `#pragma once` + include 5 组顺序、setup()/loop() 生命周期（非阻塞 `millis()` 定时器 + 不用 `delay()` + 单次 loop < 10ms）、clang-format（Google 基/4 空格/100 列/Attach）+ PlatformIO Check + cppcheck、错误处理（返回值错误码/哨兵值 NAN + 无异常 + 看门狗 `ESP.restart()` + 初始化失败不放弃）、嵌入式 C++ 限制（无异常/无 RTTI/静态分配优先/不用 `new`-`delete`/`String` 谨慎用 `char[]` 替代/`constexpr` PROGMEM）、PlatformIO 测试（Unity + native 环境）+ `platformio.ini` 依赖（`lib_deps` 版本固定 + `build_flags` 集中宏）、Arduino 专属（ISR 短小只设标志 + `volatile` + `IRAM_ATTR` + 去抖动 + EEPROM 变化才 `commit` 磨损均衡 + ESP32 Deep Sleep 唤醒源 + WiFi/MQTT 连接管理）。被 `jed-dev-arduino` 引用。
- `jed-container-style`：生产容器镜像、运行时配置与编排规范，覆盖 Dockerfile/Containerfile 生产约束、镜像规范、Compose、Kubernetes/Helm 轻量约束与安全。与 `jed-devcontainer-style`（开发）和 `jed-wsl-style`（WSL）互补。
- `jed-devcontainer-style`：开发容器规范，覆盖 Dev Container、Dockerfile.dev、Compose dev 覆盖、热重载与调试端口。与 `jed-container-style`（生产）互补。
- `jed-wsl-style`：Windows + WSL 双环境协作规范，覆盖文件系统跨界、容器引擎选型（Docker Desktop WSL2 优先）、工具链路径、换行符与 VSCode Remote-WSL。
- `jed-changelog-style`：CHANGELOG 文件格式与更新规则规范，约束 `Unreleased`、标签前缀与发布归档行为。
- `jed-uxui-spec`：UI/UX 输出规格，覆盖信息架构、用户流程、设计 token 系统（明暗主题）、布局、交互、可访问性（WCAG AA）、组件规格、高保真图能力探测序列（Excalidraw/Penpot/drawio/Sketch/AnyCap + fallback）。仅在 scope 含 UI 时调用，约束 `docs/design/uiux-spec.md` 的格式与内容深度。
- `jed-commit-style`：提交消息规范、分支模型（简化 Git Flow）与 CI 校验要求。
- `jed-pm-doc-charter`：`立项书.md` 格式与写作规范。
- `jed-pm-doc-requirements`：`需求规格.md` 格式与写作规范。
- `jed-pm-doc-hld`：`概要设计文档.md` 格式与写作规范。
- `jed-pm-doc-lld`：`详细设计文档.md` 格式与写作规范。
- `jed-pm-doc-project-plan`：`项目计划.md` 格式与写作规范。
- `jed-pm-doc-quality-plan`：`质量计划.md` 格式与写作规范。
- `jed-pm-doc-change-log`：`变更日志.md` 格式与写作规范（面向项目管理，与面向发布的 `jed-changelog-style` 互补不重叠）。
- `jed-project-memory-style`：项目记忆库规范。功能簇 + INDEX.md 导航 + `[模块.子模块.主题]` 锚点格式，同一事件所有信息聚合到单个簇文件（决策/踩坑/约束），AI 永远只加载「1 个 INDEX + 1 个簇」，最小化 token 消耗。支持动态扩展（单文件→多簇→子项目多级目录）。由 `jed-distill` 引用分簇写入。

`utils`
- `jed-list`：命令列表帮助工具 Skill，展示全部斜杠命令（支持分类筛选）。
- `jed-project-scanner`：项目结构扫描工具 Skill，用于识别目录、模块与初始化线索。
- `jed-dep-checker`：依赖检查工具 Skill，用于分析依赖、生态与基础技术线索。
- `jed-token-counter`：Token 统计工具 Skill，用于估算上下文与文档装载成本。

## 核心工作流链路

`/jed:init` 或 `/jed:onboard`
→ 生成 `local-config` + `project_memory` + CHANGELOG 骨架 + `.openspec/config`

`Idea`
→ `/jed:proposal`（OpenSpec）
→ `Spec`
→ `/jed:design`（Architect + `jed-uxui-spec`（scope 含 UI 时） + `expert-uxui`（scope 含 UI 时） + 专家）
→ `/jed:implement`（Dev + Superpowers TDD + 增量 Review）
→ `/jed:test`
→ `/jed:review`（Reviewer + Superpowers code-review + 专家）
→ `/jed:integrate`
→ `/jed:archive`
→ `/jed:release`
↻ `/jed:triage`

Design 阶段由 Architect 指定 `Assign: <dev角色>`；Implement 阶段按 Assign 加载对应 dev + 联动专家；scope 含 UI 时，design/review 自动引入 `jed-uxui-spec` + `expert-uxui`（正向设计）+ `expert-psychology`（反向审查），Architect 按 `jed-uxui-spec` 的 6 级探测序列检查图片生成能力，探测到后询问用户，未探测到时 fallback 为 ASCII 线框图。

## 快速导航：我想做 X，应该调哪个

| 我想做… | 调用顺序（→） | 说明 |
|---------|-------------|------|
| 修一个 bug | `/jed:triage` → `/jed:implement` → `/jed:archive` | triage 定位后走微变更快速通道 |
| 改个文案/调个配置 | `/jed:implement` → `/jed:archive` | 微变更，跳过 design/test/review |
| 新增一个模块（完整） | `/jed:proposal` → `/jed:design` → `/jed:implement` → `/jed:test` → `/jed:review` → `/jed:integrate` → `/jed:archive` → `/jed:distill` | 完整 SDLC |
| 新增单模块功能 | `/jed:proposal` → `/jed:design` → `/jed:implement` → `/jed:test` → `/jed:review` → `/jed:archive` | 轻量设计模式 |
| 代码审查 | `/jed:review` | 前提：test 已通过 |
| 归档已完成的实现 | `/jed:archive` → `/jed:distill` | archive 完成后建议 distill |
| 正式发布 | `/jed:release` | 前提：archive 已完成 |
| 新项目初始化 | `/jed:init` | 创建 local-config + project_memory |
| 旧项目接入 | `/jed:onboard` | 扫描现有结构兼容接入 |
| 排查一个缺陷 | `/jed:triage` | 诊断 + 判定修复路径 |
| 回退一个需求 | `/jed:revert` | 撤回 spec，同步 PM 文档 |
| 查看项目状态 | 读取 `jed-project-scanner` 输出 | 不调用 workflow |
| 检查依赖 | 读取 `jed-dep-checker` 输出 | 不调用 workflow |

## Skill 调用关系索引

标记说明：✓ = 已由 SKILL.md 正文确认；○ = 由设计意图或规范引用推断，待正文确认。

### 正向调用（谁调用了谁）

架构原则：**workflow → role → PM 文档规范**。Workflow 不直接引用 PM 文档规范，通过角色间接调用。通用标准（`jed-changelog-style`、`jed-commit-style`）和代码风格规范允许 workflow 直接引用。

| 调用方 | 被调用方 |
|--------|----------|
| `jed-init` | `jed-project-scanner`✓, `jed-dep-checker`✓, `jed-pm`✓, `jed-architect`✓, `jed-qa`✓, `jed-changelog-style`✓, `jed-commit-style`✓ |
| `jed-onboard` | `jed-project-scanner`✓, `jed-dep-checker`✓, `jed-pm`✓, `jed-architect`✓, `jed-qa`✓, `jed-changelog-style`✓, `jed-commit-style`✓ |
| `jed-proposal` | `jed-pm`✓ |
| `jed-design` | `jed-architect`○, `jed-qa`○, `jed-uxui-spec`✓（scope 含 UI 时）, `expert-uxui`○（scope 含 UI 时，正向设计）, `expert-psychology`○（scope 含 UI 时，反向审查） |
| `jed-implement` | `jed-dev-*`（按 Assign）○, `expert-*`（联动）○ |
| `jed-test` | `jed-qa`○ |
| `jed-review` | `jed-reviewer`○, `jed-changelog-style`○, `jed-uxui-spec`✓（scope 含 UI 时）, `expert-uxui`○（scope 含 UI 时，UI 深度审查）, `expert-psychology`○（scope 含 UI 时，反向审查）, `expert-*`○ |
| `jed-integrate` | `jed-architect`○, `jed-devops`○ |
| `jed-archive` | `jed-project-scanner`✓, `jed-dep-checker`✓, `jed-pm`✓, `jed-architect`✓, `jed-qa`✓, `jed-reviewer`✓, `jed-changelog-style`✓ |
| `jed-distill` | `jed-project-memory-style`✓, `jed-project-scanner`○ |
| `jed-release` | `jed-changelog-style`○, `jed-devops`○ |
| `jed-triage` | `jed-reviewer`○, `expert-*`○ |
| `jed-revert` | `jed-pm`○（回更 PM 文档） |

### 角色与 PM 文档规范归属（角色内部调用）

| 角色 | 主编的 PM 文档规范 | 参与审查的 PM 文档规范 |
|------|------------------|---------------------|
| `jed-pm` | `jed-pm-doc-charter`✓, `jed-pm-doc-requirements`✓, `jed-pm-doc-project-plan`✓, `jed-pm-doc-change-log`✓ | `jed-pm-doc-quality-plan`（成功标准对齐） |
| `jed-architect` | `jed-pm-doc-hld`✓, `jed-pm-doc-lld`✓ | `jed-pm-doc-project-plan`（技术排期）, `jed-pm-doc-quality-plan`（评审门禁） |
| `jed-qa` | `jed-pm-doc-quality-plan`✓ | `jed-pm-doc-requirements`（可测试性审查） |
| `jed-reviewer` | — | `jed-pm-doc-hld`✓, `jed-pm-doc-lld`✓, `jed-pm-doc-change-log`✓ |
| `jed-devops` | — | `jed-pm-doc-project-plan`（环境排期）, `jed-pm-doc-quality-plan`（CI/CD 采集） |

### 反向索引（谁被谁调用）

| 被调用方 | 调用方 |
|----------|--------|
| `jed-project-scanner` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓ |
| `jed-dep-checker` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓ |
| `jed-pm` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓, `jed-proposal`✓ |
| `jed-architect` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓, `jed-design`○, `jed-integrate`○ |
| `jed-qa` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓, `jed-design`○, `jed-test`○ |
| `jed-reviewer` | `jed-archive`✓, `jed-review`○, `jed-triage`○ |
| `jed-devops` | `jed-integrate`○, `jed-release`○ |
| `jed-changelog-style` | `jed-init`✓, `jed-onboard`✓, `jed-archive`✓, `jed-release`○, `jed-review`○ |
| `jed-uxui-spec` | `jed-design`✓（scope 含 UI 时）, `jed-review`✓（scope 含 UI 时） |
| `jed-commit-style` | `jed-init`✓（最小 commitlint Action）, `jed-onboard`✓（最小 commitlint Action）, `jed-archive`✓（CHANGELOG type 过滤）, `jed-review`○（提交历史审查）, `jed-devops`✓（CI 校验实现） |
| `jed-container-style` | `jed-devops`✓（生产容器化）, `jed-dev-*`○（生成生产 Dockerfile）, `jed-review`○（容器配置审查） |
| `jed-devcontainer-style` | `jed-devops`✓（开发容器配置）, `jed-init`○（预建 `.devcontainer/` 骨架）, `jed-onboard`○（补建 `.devcontainer/`）, `jed-dev-*`○（生成 Dockerfile.dev / 热重载配置）, `jed-review`○（开发容器配置审查） |
| `jed-wsl-style` | `jed-devops`✓（WSL 协作）, `jed-init`○（识别 WSL 环境、配置 `.wslconfig`）, `jed-onboard`○（同上）, `jed-dev-c-*`/`jed-dev-cpp-*`/`jed-dev-cs-*`○（Windows 系 dev 判断工具链是否走 WSL）, `jed-review`○（跨系统路径/换行符/性能审查） |
| `jed-pm-doc-charter` | `jed-pm`✓（主编） |
| `jed-pm-doc-requirements` | `jed-pm`✓（主编）, `jed-qa`✓（可测试性审查） |
| `jed-pm-doc-hld` | `jed-architect`✓（主编）, `jed-reviewer`✓（校验） |
| `jed-pm-doc-lld` | `jed-architect`✓（主编）, `jed-reviewer`✓（校验） |
| `jed-pm-doc-project-plan` | `jed-pm`✓（主编）, `jed-architect`✓（技术排期）, `jed-devops`✓（环境排期） |
| `jed-pm-doc-quality-plan` | `jed-qa`✓（主编）, `jed-pm`✓（成功标准对齐）, `jed-architect`✓（评审门禁）, `jed-devops`✓（CI/CD 采集） |
| `jed-pm-doc-change-log` | `jed-pm`✓（主编）, `jed-reviewer`✓（变更评审） |
| `jed-dev-*` | `jed-implement`○ |
| `expert-*` | `jed-design`○, `jed-implement`○, `jed-review`○, `jed-triage`○ |
| `expert-psychology` | `jed-design`○（scope 含 UI 时）, `jed-review`○（scope 含 UI 时） |
| `expert-uxui` | `jed-design`○（scope 含 UI 时，正向设计深度）, `jed-review`○（scope 含 UI 时，UI 实现深度审查） |
| `expert-simulation` | `jed-design`○, `jed-implement`○, `jed-review`○（三维仿真场景） |
| `expert-gpu` | `jed-design`○, `jed-implement`○, `jed-review`○（GPU 加速场景） |
| `expert-network` | `jed-design`○, `jed-review`○, `jed-triage`○（网络协议场景） |
| `jed-dev-rust-wasm` | `jed-implement`○ |
| `jed-dev-cpp-wasm` | `jed-implement`○ |
| `jed-dev-cs-wasm` | `jed-implement`○ |
| `jed-project-memory-style` | `jed-distill`✓（分簇写入）, `jed-design`○（写入 project_memory 规则）, `jed-archive`○（更新规则） |
| `jed-token-counter` | （待确认） |

## 关键设计决策

1. **全局 / 项目级隔离**：全局 `jed-devflow` 提供通用工作流、角色、规范、专家；项目级仅保留 `.claude/skills/local-config/SKILL.md` 做映射和覆盖，优先级为项目级 > 全局。
2. **记忆库轻量**：项目记忆库采用单文件簇 + `INDEX.md` 导航结构，AI 仅加载目标簇，降低 Token 消耗。
3. **需求归档无残留（OpenSpec）**：采用 OpenSpec 生命周期 `idea → spec → implement → archive`，`specs/active/` 目录固定；归档时将核心信息抽入 `project_memory/` 对应簇并关联 CHANGELOG。
4. **CHANGELOG 多轨由 init/onboard 落地**：全局 workflow 不规定 CHANGELOG 文件数和位置，交由 `/jed:init` 和 `/jed:onboard` 交互确认后按 scope 落地，`local-config` 记录轨映射；`jed-changelog-style` 作为跨 workflow 共用规范 Skill，统一约束 CHANGELOG 骨架、条目结构、阶段收尾归档写入与发布时版本整理。
5. **第三方工具分层**：OpenSpec 管需求生命周期，Superpowers 管实现侧增强，`jed-uxui-spec` 管 UI/UX 详细输出规范（含图片生成能力探测序列），`expert-uxui` 管 UI/UX 正向设计深度，`expert-psychology` 管认知/行为心理辅助设计审查；均不修改其本体，仅通过 `local-config` 和 workflow 覆写约束与联动。
6. **专家可对话**：`/expert:xxx` 命令可直接与专家对话，不走工作流，适合临时咨询与方案预审。
7. **Dev 角色内容可重叠**：同语言不同项目类型的 Dev 角色允许共享“语言基线”段，单独加载时不冲突。
8. **`project_memory/` 与 `specs/active/` 目录名固定**：全局 workflow 直接写死引用，不暴露配置项，不可改名，保证跨项目一致性。
9. **角色偏好可配**：角色的能力集合固定，行为力度通过偏好配置调节，配置存放在 `local-config`，由 `jed-init` / `jed-onboard` 交互确认，项目级可覆盖，未配置时使用默认值。
10. **GitHub Action 分层落地**：CI 配置分两层建立。`jed-init` / `jed-onboard` 在初始化阶段生成**最小 commitlint Action**，只校验提交消息格式（引用 `jed-commit-style`），所有项目通用。完整 CI（构建、测试、发布）由 `jed-devops` 在 `jed-design` / `jed-implement` 阶段补全，依赖技术栈和项目类型。`jed-commit-style` 只定义规范不写 yaml 实现，CI 的具体配置由 `jed-devops` 承担。
11. **容器规范三层分立**：容器相关规范拆为三个独立 Skill，职责不重叠。`jed-container-style` 约束**生产**镜像、运行时配置、Kubernetes/Helm 轻量清单。`jed-devcontainer-style` 约束**开发调试**容器（Dev Container、Dockerfile.dev、Compose dev 覆盖、热重载、调试端口），与生产规范力度相反（允许 root、latest、不强制扫描）。`jed-wsl-style` 约束 Windows + WSL 双环境协作（文件系统跨界、容器引擎选型、工具链路径、换行符、VSCode Remote-WSL），不局限于容器场景。三者均由 `jed-devops` 引用，也被 dev 角色和 init/onboard 按需引用。

## 角色偏好配置

角色的能力在任何项目里都一样，真正变化的是**行为力度**——追问多深、边界卡多严、建议多强势。偏好配置只调节行为力度，不改变能力集合。

配置由 `local-config` 管理，`jed-init` / `jed-onboard` 阶段交互确认，项目级可覆盖全局默认值。未配置时使用各角色的默认值。

### 机制

```yaml
# local-config 中的角色偏好段落
role-style:
  pm-style:
    rigor: balanced          # 严格度
    scope-control: guardian  # 范围控制倾向
    decision-mode: advisory  # 决策建议的强势程度
  # 其他角色的偏好维度按需扩展
```

### 设计原则

- **能力复用，行为可调**：不拆分多个子角色，一套能力 + 偏好配置覆盖不同项目文化
- **默认值即可用**：不配置也能正常工作，默认值面向大多数项目
- **维度独立**：每个偏好维度独立设置，不强制绑定
- **角色自管**：每个角色在自己的 SKILL.md 中定义偏好维度、选项、默认值和影响说明

### 已定义的角色偏好

#### jed-pm

| 维度 | 选项 | 默认 | 影响 |
|------|------|------|------|
| `rigor` | `strict` / `balanced` / `lean` | `balanced` | strict：每个需求点追问到可验证才算确认；balanced：关键模糊点追问，次要的标注待澄清；lean：只追问阻塞性问题 |
| `scope-control` | `guardian` / `flexible` | `guardian` | guardian：任何范围扩展都走变更流程；flexible：小范围扩展可直接纳入但必须记录到变更日志 |
| `decision-mode` | `advisory` / `assertive` | `advisory` | advisory：给分析和建议，决策留给用户；assertive：明确给出推荐方案并推动执行，但最终仍需用户确认 |

#### jed-architect

| 维度 | 选项 | 默认 | 影响 |
|------|------|------|------|
| `design-depth` | `comprehensive` / `essential` | `comprehensive` | comprehensive：概要设计 + 详细设计都完整产出；essential：概要设计完整，详细设计只覆盖核心模块，其余标注"待细化" |
| `tech-bias` | `conservative` / `progressive` | `conservative` | conservative：优先成熟稳定方案，新技术只作为备选；progressive：主动列创新方案，与成熟方案并列对比 |
| `assign-mode` | `recommend` / `specify` | `recommend` | recommend：推荐 dev 角色由用户确认；specify：直接指定 dev 角色，但仍需用户确认 |

#### jed-qa

| 维度 | 选项 | 默认 | 影响 |
|------|------|------|------|
| `test-coverage` | `thorough` / `risk-based` | `thorough` | thorough：全范围覆盖，测试用例追求完整；risk-based：按风险优先级分配测试资源，高风险模块重点测 |
| `gate-strictness` | `strict` / `pragmatic` | `strict` | strict：门禁条件全部满足才放行；pragmatic：关键门禁满足即可，非关键项标注"已知限制"放行 |
| `release-mode` | `cautious` / `confident` | `cautious` | cautious：发布条件从严，残余风险必须显式声明；confident：发布条件从宽，核心通过即推荐发布 |

#### jed-reviewer

| 维度 | 选项 | 默认 | 影响 |
|------|------|------|------|
| `review-depth` | `comprehensive` / `focused` | `comprehensive` | comprehensive：全量审查（设计+代码+变更+回归）；focused：按变更范围聚焦审查，未变更部分不审查 |
| `severity-bias` | `strict` / `lenient` | `strict` | strict：问题从严分级，轻微问题也可能标"一般"；lenient：从宽分级，非阻塞问题尽量降级为"建议" |
| `fix-suggestion` | `detailed` / `brief` | `detailed` | detailed：给出具体修复代码或伪代码；brief：只指出问题方向，不给具体代码 |

#### jed-devops

| 维度 | 选项 | 默认 | 影响 |
|------|------|------|------|
| `deployment-strategy` | `blue-green` / `rolling` / `canary` | `blue-green` | blue-green：蓝绿部署，切流即可回滚；rolling：滚动更新，逐步替换；canary：金丝雀发布，小流量验证再全量 |
| `automation-level` | `full` / `semi` | `full` | full：全自动化，CI/CD 流水线端到端；semi：关键步骤保留人工确认点 |
| `rollback-readiness` | `always` / `on-failure` | `always` | always：每次部署都准备回滚方案；on-failure：只在失败时才考虑回滚 |

5 个角色的偏好维度现已全部定义，后续新增角色按需定义各自的偏好维度，遵循同样的机制和原则。

## 填写约束

当前仓库结构已恢复为分类目录 + 目录式 Skill 文件。后续所有 Skill 都应直接填写到各自的 `SKILL.md` 中。

建议每个 Skill 至少包含以下结构：

- frontmatter：`name`、`description`
- `# Title`
- `## Purpose`
- `## When To Invoke`
- `## Inputs` 或 `## Required Context`
- `## Steps`
- `## Output`
- `## Guardrails`
- `## Examples`

## 快速开始

1. 将 `jed-devflow` 放入 `~/.claude/plugins/`，Claude Code 自动识别。
2. 全局 Skill 统一维护在 `skills/<group>/<skill-name>/SKILL.md`。
3. 项目根执行 `/jed:init`（新项目）或 `/jed:onboard`（旧项目），生成 `.claude/skills/local-config/SKILL.md`、`project_memory/`、CHANGELOG 骨架和 `.openspec/config.yaml`；`jed-changelog-style` 会在初始化、旧项目接入、`jed-archive` 阶段收尾和正式发布等阶段共同约束 CHANGELOG 格式与更新方式。
4. 从 `/jed:proposal` 开始，走完整链路。

## 优化记录

### v0.2.0 迭代完成（2025-06-28）

| 优先级 | 完成项 |
|--------|--------|
| P0 | 微变更快速通道（triage 判定实现层+微变更 → implement→archive）、PM 文档与 spec 一致性比对（archive 回更前检查 6 种 PM 文档 vs OpenSpec）、新增 jed-revert 回退流程 |
| P1 | 补强 jed-devops（6 技术栈 CI 模板 + Docker + Trivy）、jed-distill 增加蒸馏预览、token-counter 按文件类型细分系数 |
| P2 | 3 个 WASM dev（Rust/C++/C#）、expert-simulation（三维仿真）、expert-gpu（GPU 加速）、快速导航表 |
| P3 | PM 文档 minimal 模式（local-config 开关）、project_memory 老化机制（15KB 拆分提醒 + 手工删除规则，去掉 90 天自动归档）、expert-network（HTTP/2+HTTP/3+gRPC+WebSocket） |

**P3-2 决策：不合并 test+review。** test 和 review 职责不同（功能正确性 vs 路线正确性），分开保留独立调用能力更优。

## License

MIT