القائمة
Use when implementing approved docs/vX.Y.Z/plans/*.md tasks with frontend TDD.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when starting, resuming, or continuing a versioned frontend iteration with docs/vX.Y.Z/ inputs.
Use when turning docs/vX.Y.Z/design/*.md into TDD implementation plans for a versioned frontend iteration.
Use when turning docs/vX.Y.Z/prd/summarized/*.md into frontend technical designs for a versioned iteration.
Use when preparing release materials after docs/vX.Y.Z/review/*.md and test-report.md pass.
Use when turning docs/vX.Y.Z/prd/origin/*.md into frontend-focused summarized PRDs for a versioned iteration.
Use when reviewing implemented frontend iteration work against docs/vX.Y.Z/ requirements, design, plans, and test report.
| name | frontend-implement |
| description | Use when implementing approved docs/vX.Y.Z/plans/*.md tasks with frontend TDD. |
| disable-model-invocation | true |
按 plan（TDD 计划）实现，改动不超出已确认方案
| 路径 | 必需 | 说明 |
|---|---|---|
docs/technical-architecture.md | 是 | 技术栈、目录、命令、约定 |
docs/vX.Y.Z/plans/*.md | 是 | 任务边界 |
docs/vX.Y.Z/design/*.md | 是 | plan 不清时查 |
docs/vX.Y.Z/prd/summarized/*.md | 是 | 验收、行为边界 |
docs/vX.Y.Z/progress.md | 是 | 步骤/task、TDD 证据、阻塞项 |
| 代码库 | 是 | 跟既有模式 |
缺必需项则停止
frontend-design 或 frontend-planfrontend-iteration/references/orchestrated-invocation.mdfrontend-iteration/references/agent-communication-style.mddocs/technical-architecture.md、目标 plans/*.md；plan ACTIVE，待确认问题已关progress.md；定范围：全 plan / 指定 plan·task / resume 首未完成 taskprogress.md 无表则从 docs/technical-architecture.md → 代码风格 提炼 5–10 条写入；见 frontend-iteration/references/code-style-enforcement.mdin_progressprogress.md；问是否提交；确认后 commit；不自动 pushfrontend-test → test-writing-guide；RED 失败正确才 GREENprogress.md；不只聊天frontend-iteration/references/api-integration-guide.md；封装占位；TODO(vX.Y.Z): 接口联调待定；页面不 fetch、不写死占位frontend-iteration/references/orchestrated-invocation.md；上游不可用 → 停<type>(<scope>): <description> — Conventional Commitstype：feat/fix/refactor/style/test/docs/chore/perf/build/ciscope：可选，页面/模块名description：祈使、小写起、无句号；概括 task 目标feat(user-profile): add avatar upload field
fix(login): handle empty token response
test(user-profile): cover avatar validation rules
读目标与依赖 → 前置 task 已过
↓
RED：最小失败测试；确认失败原因
↓
风格重载：progress.md → 风格锚点 + 邻文件
↓
GREEN：最小实现（API 占位/TODO 见 api-integration-guide）
↓
REFACTOR：必要时清理；测试仍过
↓
VERIFY：task 验证命令（+ lint/typecheck 若配置）
↓
过 → 汇报 → 问提交 → 确认后 commit（可选）
↓
下一 task；失败 → 修或停
| 场景 | 处理 |
|---|---|
| 多 plan | 按依赖顺序；共享文件注意冲突 |
| 从 Task N 续 | 读 progress.md；Task 1…N-1 已过 VERIFY |
| API 与后端不一致 | 封装标 TODO(vX.Y.Z): 接口联调待定 + 占位；阻塞 UI → design |
| 上游 STALE | 停；回对应步骤 |
| 验证命令不存在 | docs/technical-architecture.md 找等价；仍无 → 停 |
| 需 plan 外文件 | 停；回 plan 补 task |
| 用户暂不提交 | 记未提交；告知后续混合 |
| dead code | 不清理，除非 plan 含 |
ACTIVEprogress.mdfrontend-iteration/references/step-gates.md 核对frontend-iteration/references/progress-convention.md “每步最小落盘” 小节落盘 progress.mddocs/technical-architecture.md）TODO(vX.Y.Z): 接口联调待定 清单（若有）读 skill / reference 时按序尝试（命中即用）：
| 资源 | 路径 1（npx skills add） | 路径 2（源码） |
|---|---|---|
本子 SKILL.md 目录 | .agents/skills/frontend-implement/ | skills/frontend-implement/ |
| 编排 references | .agents/skills/frontend-iteration/references/<file> | skills/frontend-iteration/references/<file> |
| 其他 references | .agents/skills/<name>/references/<file> | skills/<name>/references/<file> |
| 样例 | .agents/skills/frontend-iteration/examples/ | skills/frontend-iteration/examples/ |