technical-planning

name	technical-planning
description	进行技术方案设计、受影响文件寻找与改动风险分析。
metadata	{"internal":true}

Technical Planning Skill (技术规划技能)

核心能力 (Core Capabilities)

• 文件寻路: 准确找到特定逻辑所在的文件位置，避免修改错误的副本。
• 影响评估: 识别修改全局 Composable、Store 或 API 时可能波及的页面或组件。
• 契约定义: 在动工前定义好 API 的路径、入参和返回结构。
• 准入前置: 在输出技术方案前，先确认该事项是否属于当前规划，避免为低优先级新想法提前展开实现设计。
• 解耦建议: 建议将紧耦合逻辑拆离，确保护合项目架构准则。

指令 (Instructions)

1. Worktree 感知: 识别任务属性，在输出改动清单时，应明确改动应在哪个工作树（如 ../momei-dev）中执行。
2. 先给准入结论: 在输出任何实现清单前，先明确该事项是“当前范围内执行”“允许插队执行”还是“仅记录为后续规划”。如果结论是延期，则不应展开完整开发方案。
3. 清单优先: 对允许执行的事项，在执行任何 Do 操作前，必须先输出一份包含“受影响文件”和“改动逻辑点”的清单。
4. 路径验证: 确保提及的文件路径在当前工作区真实存在。
5. 模式沿用: 优先参考项目中已有的相似实现模式。

使用示例 (Usage Example)

输入: "我们要加一个点赞功能。" 输出: "需要修改 server/database/Post.ts 添加字段，创建 server/api/like.post.ts，并在 components/article-card.vue 添加点赞按钮。"

输入: "测试时发现一个未来可优化的交互点。" 输出: "结论：延期进入 backlog。当前不输出详细实现清单，只记录可能涉及的模块范围，避免打断本迭代。"