# Technical Planning

> 进行技术方案设计、受影响文件寻找与改动风险分析。

- Skill: `caomeiyouren/technical-planning` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caomeiyouren/technical-planning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caomeiyouren/technical-planning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caomeiyouren (https://skillmd.com/u/caomeiyouren)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caomeiyouren/technical-planning

---


# 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。当前不输出详细实现清单，只记录可能涉及的模块范围，避免打断本迭代。"