Dev Plan Assistant

August 11, 2026 · View on GitHub

「先想清楚,再做干净」 — 项目初始化与开发规划的总控制者。 内置「设计中心」模板,兼容多 AI 平台(REASONIX / CLAUDE / AGENTS)。

这是什么

一个项目开发控制流程 skill,做两件事:

  1. 初始化项目:AI 读取本 skill 内置的 template/,自动在目标项目生成——
    • docs/design/ 设计中心(architecture / modules / flows / standards)
    • docs/design/plans/ 计划与开发记录
    • docs/standards/ 前后端规范(frontend-standards / backend-standards)
    • 多平台 AI 指令文件(REASONIX.md / CLAUDE.md / AGENTS.md,检测 + 补全)
  2. 规划模块开发:每次模块/功能开发前必须调用——反问需求 → 对照设计中心质疑架构(发现错误必须指出并等确认)→ 更新设计中心 → 写入计划。

安装

把整个仓库复制到你的 skills 目录(二选一):

  • 全局(所有项目可用):C:\Users\<你>\AppData\Roaming\reasonix\skills\dev-plan-assistant\
  • 项目级(仅当前项目):<项目>\.reasonix\skills\dev-plan-assistant\

复制后目录结构:

dev-plan-assistant/
├── SKILL.md              # 控制流程(初始化 / 规划 / 记录)
└── template/             # 内置模板(AI 初始化项目时读取)
    ├── design/           # 设计中心骨架
    ├── agents/           # 多平台指令片段(REASONIX/CLAUDE/AGENTS)
    └── plans/            # 计划与开发记录模板

使用

初始化项目

对 AI 说:「新建项目」「把设计中心接入这个项目」即自动触发。

  • 场景 A(已有代码):跳过技术调研 → AI 反向提炼真实架构 → 生成规范(读实际代码)→ 用户确认。
  • 场景 B(空项目):反问需求 → 技术调研(避免重复造轮子)→ 从零设计架构 → 用户确认 → 里程碑计划。

模块开发

对 AI 说:「开发 XX 模块」——约定强制先走规划(反问 → 质疑架构 → 更新 docs/design/modules.md → 计划写入 docs/design/plans/)再开发;任务完成后输出设计对照报告(实现 / 偏离 / 进度)。

分层标准

内容何时用
L1 设计中心(docs/design/)架构、模块、流程模块/架构级功能先更新再开发
L2 本 skill(规划)反问 + 质疑 + 更新设计中心模块/新功能开发前必须调用
L3 规范(docs/standards/)前端/后端编码标准所有代码改动必须遵循(含小功能)

原理

  • 设计中心是事实源docs/design/ 为项目设计唯一权威,AI 开发前必读、偏离必须显式说明并回写、任务后自动对账。
  • AI 自动复制模板:初始化时 AI 用 read_file 读取本 skill 的 template/ 写入目标项目,无需手动复制。
  • 多平台兼容:指令文件按项目已有检测补全(REASONIX.md / CLAUDE.md / AGENTS.md),不依赖单一 AI 平台。

文件说明

文件说明
SKILL.md控制者流程(安装后即被 AI 加载执行)
template/design/*.md设计中心骨架(初始化时复制到项目 docs/design/
template/agents/*.md三平台 AI 指令片段(初始化时写入项目根)
template/plans/README.md计划与开发记录模板(初始化时复制到项目 docs/design/plans/
references/规划方法论参考(技术调研、C4 架构、CLAUDE.md 生成)

许可

MIT(见 LICENSE)。