Write idea docs

Skill JunfengRan/dev-env/skills/write-idea-docs

在 dev-env 撰写或修订开源设计文档（架构 / 技术栈 / 工作流 / 选型决策）。触发：用户要求写架构设计、技术栈总览、方案取舍、选型决策；新建或修改 docs/design/ 下 *-architecture.md、*-tech-stack.md、*-workflow.md、*-selection.md。From its SKILL.md

Install

npx -y skills add JunfengRan/dev-env --skill write-idea-docs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, 441 tokens by cl100k_base, as published. Nobody here has run it

设计文档写作

将产品/系统想法写成 可评审、可落地、可横向对比 的设计文档。

文档类型与命名

类型	文件名模式	输出目录
架构	`{topic}-architecture.md`	`docs/design/`
技术栈	`{topic}-tech-stack.md`	`docs/design/`
工作流	`{topic}-workflow.md`	`docs/design/`
选型决策	`{topic}-selection.md`	`docs/design/`

统一工作流

1. 定类型与命名 → 2. 写 metadata → 3. 列大纲 → 4. 写核心 Idea
→ 5. 方案取舍表 → 6. 架构图 → 7. 交叉链接 → 8. 验证

选型决策文档必须含：选型前提、竞品对比、编号 catalog（XX-NN）、优先级表（P0–P3）。

模板见 references/architecture-template.md、references/tech-stack-template.md。

验证

Mermaid → npm run validate:mermaid
深度 → references/depth-checklist.md
deep-research decide 阶段 → gate decision-doc-complete

协作

意图/方案未对齐时 → 可选 brainstorm（启发式，非必经）
画图 → draw-mermaid-diagrams
由 deep-research workflow 的 decide 状态调用

What ships with it: 3 files

3.3 KB alongside SKILL.md