技能介绍

问题在哪

学习项目、作品集、实习/校招/竞赛作品和面试复盘里，常见痛点不是「不会写某行代码」，而是不知道这个项目现在算什么状态、该先动哪一块。通用编程助手容易一上来就改文件或给逐步教程，和「我要把项目讲清楚、按模块推进」的目标错位。

技能怎么跑

触发后默认走项目发现，而不是默认写代码：

判断当前目录是否是项目；没有明确信号就先要路径。
扫描 README、配置、入口、路由、模型/服务、测试等，目的是理解现状，不是立刻挑刺。
用工程师能复述的语言概括：项目类型、已有功能、完成度、半成品痕迹、自然下一步。
按功能模块拆分（如编辑器、撤销重做、本地存储），而不是把 DDD 分层当成「模块名」。
用专业但克制的词描述架构（MVC、MVVM、Clean 等）；只像某种模式就说「像」，不硬贴标签。
再问用户：继续开发、整理结构、还是解决具体问题；从哪个模块入手。

要改模块时，先对齐目标行为、交互流、输入输出与状态、持久化时机、错误与边界、与现有模块关系、明确不做什么。缺信息就问，不猜。计划清楚后给 Mermaid 和缩进箭头式两套流程图，再让用户选自己写还是让 Agent 写。

用户自己写：步骤、检查点、验收标准、风险；不给完整实现、不改文件。
Agent 写：严格按计划实现；改完后读真实文件，在 /docs/logs/ 写完成日志，并用面试能讲的大白话做功能总结，附几道专业措辞的面试题。

用户说「做完了」时，技能要求重新打开仓库核对变更，而不是只靠对话记忆。

边界与注意

刻意忽略纯风格类问题（分号、空格、普通 lint），除非影响行为或阻塞进度。详细分阶段说明在 references/planning.md、references/coaching.md、references/review-checklist.md 中按场景引用。语言跟随用户主用语（中文或英文）。