ia-planning
基于文件的代码变更规划工具，用于管理涉及多文件的复杂修改。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ia-planning。 它的用途是：基于文件的代码变更规划工具，用于管理涉及多文件的复杂修改。 完整的 Skill 内容见：https://321skill.com/skills/ia-planning-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我需要为我们的用户系统添加一个双因素认证功能，这可能会影响到用户模型、认证API和前端设置页面。’，它会引导你创建一个 .plan 文件，让你详细描述功能、列出所有可能受影响的文件、拆解实现步骤并预估风险，最终生成一份清晰的开发路线图。
介绍
ia-planning 是一个专为软件开发者设计的规划工具，旨在解决在涉及多个文件或范围模糊的代码变更前，因缺乏系统规划而导致返工、遗漏和沟通成本高的问题。它通过创建结构化的 .plan 文件来引导开发者明确变更范围、列出受影响文件、预估工作量并记录关键决策，将模糊的想法转化为可执行的开发蓝图。
使用时，开发者只需在项目根目录运行相关命令即可初始化规划。工具会引导你填写变更描述、关联文件、拆解任务步骤，并将这些信息持久化到 .plan 目录下的文件中。整个过程类似于创建一个轻量级的、机器可读的设计文档，确保所有思考过程都被记录和存档。
该工具非常适合负责复杂功能开发、重构或系统升级的开发者，尤其是全栈开发、后端开发和运维开发工程师。当任务涉及三个及以上文件，或者需求边界不清晰、需要提前梳理影响面时，使用它能显著提升开发条理性和代码质量。
建议在开始编写实际代码前使用本工具。对于明确的单文件修复（如修复拼写错误）或仅产生报告的研究、扫描类工作，则无需使用。规划完成后，生成的 .plan 文件可作为代码审查的补充材料，帮助团队成员快速理解变更意图和实现路径。
核心特点
与同类规划工具或备忘录不同，ia-planning 强制采用基于文件的持久化存储（.plan/目录），将规划过程结构化并直接与代码仓库绑定，使规划文档成为项目资产的一部分，而非临时笔记。
注意事项
不适用于修复拼写错误、单文件修改，或仅产出报告而非代码的研究、扫描、审计类工作。
常见问题
ia-planning 适合用来规划写技术文档或设计稿吗？
不适合。它专为规划会产生代码的软件实现任务而设计，对于纯文档或设计工作，建议使用其他工具。
.plan 文件应该提交到代码仓库吗？
是的，建议提交。这能让团队共享规划上下文，便于后续审查和追溯决策原因。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ia-planning-x-7/raw/index.md 读取 ia-planning 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ia-planning-x-7/raw/index.md（查看排版版本）