AGENT SKILL
deveco-requirement-development
覆盖鸿蒙/HarmonyOS/ArkTS 应用需求开发流程。在用户要落地新功能/新页面/新模块、PRD、端到端需求开发或鸿蒙应用开发时使用。不用于仅询问 API 语法用法、或未声明走完整链路的单文件 Bug 修复。用户意图模糊时先澄清是否需要端到端交付。
- License 许可
- GPL-3.0
- 最近更新
- 2026-10-08
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- deveco-requirement-development
- description
- 覆盖鸿蒙/HarmonyOS/ArkTS 应用需求开发流程。在用户要落地新功能/新页面/新模块、PRD、端到端需求开发或鸿蒙应用开发时使用。不用于仅询问 API 语法用法、或未声明走完整链路的单文件 Bug 修复。用户意图模糊时先澄清是否需要端到端交付。
02 资源文件 5
- 参考文档reference/coding.md14.7 KB
- 参考文档reference/common.md9.1 KB
- 参考文档reference/prd-gen.md22.9 KB
- 参考文档reference/prd-quality-gate.md5.9 KB
- 参考文档reference/review.md9.1 KB
03 SKILL.md 正文
鸿蒙需求开发工作流
本技能覆盖 需求 → 编码/联调 → 评审 全链路;各阶段细则在 reference/ 对应文档中(prd-gen、coding、review)。通用规则统一收敛在 reference/common.md。按用户当前任务只读取相关 reference,做端到端需求时按下方总览顺序推进。
全流程总览
阶段一 调研与设计稿 → PRD 定稿 → 见 reference/prd-gen.md
↓
阶段二 编码、静态检查、编译、推包、联调验收 → 见 reference/coding.md
↓
阶段三 代码评审与经验沉淀 → 见 reference/review.md
分阶段参考文件(按需读取)
详细说明均在 reference/ 子目录中;从本 SKILL.md 直接读取下表链接(一层引用,勿再嵌套跳转)。
| 阶段 | 参考文件 | 典型用户表述 |
|---|---|---|
| 通用规则 | reference/common.md | 可选目录、复用策略、失败重试、沉淀策略 |
| PRD 与调研 | reference/prd-gen.md | 需求文档、PRD、设计稿、调研 |
| PRD 质控与定稿阈关 | reference/prd-quality-gate.md | PRD 验收清单、技术校准、一致性审查、设计稿版本记录 |
| 编码与联调 | reference/coding.md | 编码、coding、实现、编译、构建、debug、联调、修复、验收 |
| 评审 | reference/review.md | review、评审、CR、代码审查 |
读取规则:
- 默认先读
reference/common.md,再读与当前目标最相关的 1 个阶段参考文件。 - 以下场景优先级高于"1 个"限制,必须额外追加读取,不计入默认 1 个名额:
- 进入 PRD 阶段三,或用户提到"验收清单/技术校准/一致性审查/设计稿版本记录",在进入阶段三时立即追加读取
reference/prd-quality-gate.md,不得提前或延后。 - 涉及 UI Pattern 刷新、复用判定或 Pattern 缺失降级,必须按
reference/prd-gen.md阶段一-B 读取相关 Pattern 文档(执行时机:阶段一-A 用户确认后、阶段二写 PRD 前)。 - 用户要求从需求端到端推进时,按大阶段增量读取下一参考文件,禁止一次性全量加载全部 reference。
- 进入 PRD 阶段三,或用户提到"验收清单/技术校准/一致性审查/设计稿版本记录",在进入阶段三时立即追加读取
按需入口(按任务选 reference)
- 用户只谈 需求/设计稿 →
reference/prd-gen.md - 用户只谈 写代码/编译(新功能/结构改动) →
reference/coding.md(进入前需确认 PRD 已定稿;若无 PRD,先回到reference/prd-gen.md)。 - 用户只谈 Bug/联调/快修(局部修复) →
reference/coding.md(可不经过完整 PRD,但需先确认 issue/复现步骤/预期行为)。 - 用户只谈 Review →
reference/review.md。 - 用户直接提供设计稿链接(Figma / MasterGo / Sketch 等 URL),未给出粗略需求文字描述 → 仍需从
reference/prd-gen.md阶段零开始,先向用户确认调研范围(Step 1),再解析设计稿;禁止跳过阶段零直接进入阶段一。 - 用户表述为 功能升级 / 对已有 PRD 做改动 → 先查
/docs/prd/README.md索引定位已有 PRD,评估变更范围后选择入口:局部调整走coding.md变更处理节;逻辑级以上变更需回到reference/prd-gen.md阶段一-A 重新论证,在原 PRD 文件上追加版本标注后继续。
用户明确要求从需求一路做到上线时:按总览顺序推进;上一阶段产出满足「进入下一阶段条件」后再打开下一参考文件。
用户越权请求处理
当用户请求跳过当前未完成阶段直接进入下一阶段时,不得静默执行,必须明确说明缺少的前置条件并引导补齐。以下为常见场景与标准回应:
| 越权场景 | 缺少的前置 | 标准引导话术 |
|---|---|---|
| PRD 未定稿时要求开始编码 | PRD 阶段四前置阈关未通过 | "当前 PRD 尚未完成定稿阈关检查(§11/§11.5/§11.6/§12),进入编码存在返工风险。建议先完成质控,还是继续编码(并接受该风险)?" |
| 调研报告未确认时要求写 PRD | 阶段零 Step 4 用户确认 | "调研报告尚未经用户确认(阶段零 Step 4),直接写 PRD 可能遗漏模块边界问题。请先确认调研报告,或明确说明跳过风险。" |
| 编码阶段 §10 阻塞项未解决 | §10 中存在 [阻塞编码] 项 | "PRD §10 中存在 [阻塞编码] 未解决项(列出具体条目),建议先解决后再开始编码,否则可能需要大范围返工。" |
| 联调验收未完成时要求提 Review | coding.md 阶段八验收通过 | "功能验收(coding.md 阶段八)尚未完成,直接进入 Review 可能审出大量功能问题。建议先完成验收,再提 Review。" |
人工必须介入的检查点
本表为索引,细则以对应 reference 文件为准,此处不重复定义。
| 时机 | 所在 reference |
|---|---|
| 阶段零完成后(调研报告确认) | prd-gen.md 阶段零 Step 4 |
| 设计稿解析后、写 PRD 前(方案论证确认) | prd-gen.md 阶段一-A Step 5 |
| 进入编码前(PRD §10 阻塞项全部解决) | prd-gen.md 阶段四前置阈关 |
| 第一批骨架后(新增依赖/路由/服务注册工程同步) | coding.md 阶段一 §1.2 |
| 联调完成后(功能验收) | coding.md 阶段八 |
| 评审阶段(P0/P1 修复) | review.md 阶段二 |
| 评审完成后(经验沉淀) | review.md 阶段五 |
| 疑难定位后(修复计数超过5次强制挂起) | coding.md 阶段七 Step 5 |
04 同仓库更多 Skills
writing-for-agents
为 agent 撰写文档。当创建或编辑 skill、修改 AGENTS.md 或 CLAUDE.md 时使用。
★ 3
wait-what
停。上一条消息没讲明白:换个说法再讲一遍。
★ 3
to-questionnaire
把你无法独自回答的决策转化成一份问卷,交给别人填写。
★ 3
teach
在当前工作区内,教会用户一项新 skill 或概念。
★ 3
handoff
把当前对话压缩成一份交接(handoff)文档,供另一个代理接手。
★ 3
grilling
就一个计划、决策或想法对用户进行无情的访谈。当用户想压力测试自己的思路,或使用任何 'grill' 触发短语时使用。
★ 3