engineering-design

Plugin engineering-design from marketplace ai-marketplace in xiaolfeng/ai-marketplace. Commands read from the repo's manifest — 6 days ago.

Skills (9)

• design-er

  编写与演进 docs/engineering/design/ 中的工程设计稿，覆盖 draft（起草）→ rfc（提案描述/评审） → adr（定稿约束/冻结）全周期。当需要设计模块职责、数据与接口契约、备选方案对比、异常处理和验证方式， 或用户说「写设计稿」「写详细设计」「写个设计提案」「把这个设计定稿为 ADR」「/design-er」时使用。

• docs-adventure-init

  工程文档高级增量初始化。先检查 docs/ 基础结构是否就绪（若为空或缺失则先自动调用 docs-init 完成基础初始化）， 再增量创建 docs/reader/（专门放置面向用户直读的 .html 界面或高级渲染图）与 docs/develop/（AI 保留有价值但 不便归入 engineering 四模式的工程信息记录，不保留记录状态），并同步更新 docs/README.md 与 MAINTENANCE.md。 用户说「高级初始化」「初始化高级文档」「docs-adventure-init」「添加 reader 和 develop 目录」「/docs-adventure-init」时使

• docs-clean

  整理工程文档与实施计划卫生。检查 docs/engineering/{research,design,spec,runbook} 与 docs/plan/ （含 docs/plan/archive/）是否按模式独立取号（串号、空洞、撞号）、相对链接是否打空、文件是否放错目录 （含终态计划未归档、顶层遗留 plan/ 或遗留旧目录）、docs/engineering/MAINTENANCE.md 是否就位，并核对 docs/README.md 与 docs/plan/README.md 索引、状态机取值（含 docs/develop/ 无状态要求）、Scope 词表、 superseded 双向

• docs-init

  初始化工程文档与实施计划目录结构。在新项目中幂等搭建 docs/engineering/{research,design,spec,runbook} 四模式目录、docs/engineering/MAINTENANCE.md 维护公约、docs/README.md 分模式索引，以及同级 docs/plan/（含 docs/plan/archive/ 与 docs/plan/README.md），或用户说「初始化文档」「init docs」「建文档目录」 「补齐文档结构」「/docs-init」时触发。幂等操作，重复执行安全。

• docs-move

  将不规范或旧版的项目文档迁移并整理为当前 engineering-design 规范样式。支持把旧版顶层 plan/ 迁入 docs/plan/、 将旧版 draft/rfc/adr 独立目录归并为 design/spec 单文件原位演进、将散落的 .html 渲染物与无状态工程笔记分流至 docs/reader/ 与 docs/develop/，并完成独立四位取号重命名、文首元信息修补、标准章节骨架重构、全仓相对链接修正 与索引同步。用户说「迁移旧文档」「整理不规范文档」「docs-move」「把旧文档改成新规范」「升级文档结构」「/docs-move」时使用。

• plan-er

  编写、推进与归档 docs/plan/ 目录下的工程实施与迁移计划，覆盖活动态（draft → ready → in-progress， 平铺于 docs/plan/）与终态归档（done / cancelled / superseded，移入 docs/plan/archive/）。当需要规划分阶段改造路线、 存量兼容迁移、切流回滚步骤与任务拆解，或用户说「写个实施计划」「迁移方案」「演进路线图」 「把计划归档」「/plan-er」时使用。

• research-er

  写调研笔记（docs/engineering/research/）时使用。调研外部标准、技术机制、竞品方案， 或用户说「调研一下」「看看 X 是怎么实现的」「对比几个方案」「/research-er」时触发。 只记录现状与证据，直接产出调研结果（无过程状态），方向判断标「倾向」而不直接拍板。

• runbook-er

  编写与维护 docs/engineering/runbook/ 中的运行与排障手册（SOP），覆盖 draft（编写中） → active（现行有效）→ deprecated（已停用）生命周期。当需要记录部署发布步骤、环境配置、 告警排查、故障止血回滚或日常维护操作，或用户说「写个运维手册」「排障手册」「runbook」 「故障应急预案」「操作手册」「/runbook-er」时使用。

• spec-er

  编写与演进 docs/engineering/spec/ 中的技术与工程规范，覆盖 draft（起草）→ rfc（提案描述/评审） → adr（定稿约束/冻结）全周期。当需要制定跨模块标准、协议格式、命名/目录约定、架构红线或上架准入规则， 或用户说「写个规范」「定个标准」「写协议规范」「把这条规矩冻住」「/spec-er」时使用。

Similar plugins