ia-planning
基于文件的多文件变更规划工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:ia-planning。 它的用途是:基于文件的多文件变更规划工具 完整的 Skill 内容见:https://321skill.com/skills/ia-planning-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我想在用户模块中增加邮箱验证功能,涉及注册、登录、忘记密码三个接口和数据库迁移,请帮我用 ia-planning 生成实现计划'。AI 会初始化 .plan/ 目录,列出每个文件(如 register.ts、login.ts、resetPassword.ts、migration.sql)的修改目标、依赖顺序和测试要点,并生成可视化的步骤清单。
介绍
在开发过程中,当需要修改3个以上文件或变更范围不清晰时,手动规划容易遗漏或导致混乱。ia-planning 通过文件持久化(.plan/ 目录)来记录和跟踪实现计划,帮助开发者系统性地拆解复杂任务、明确每个步骤的依赖关系和输出,避免遗漏关键变更。
使用方式非常简单:在项目根目录下初始化 .plan/ 目录后,AI 助手会根据你的需求自动生成结构化的实现计划,包含每个文件的修改目标、依赖关系和检查清单。你可以随时查阅、更新计划,AI 会同步状态并提醒下一步操作。
适合全栈开发、后端开发以及项目经理在多人协作或跨模块功能开发时使用。特别适用于重构、新增功能、技术方案落地等场景,能有效降低沟通成本和返工风险。
注意:本工具不适合单文件修复、拼写错误修正、纯研究或审计类工作(产出报告而非代码),也不适合需要频繁调整计划的小型任务。建议在计划阶段花5-10分钟生成提纲,后续开发中定期同步状态。
核心特点
与同类规划工具相比,ia-planning 采用文件持久化存储(.plan/),支持离线查看和版本控制,且专门针对跨多文件(3+)或模糊范围的代码变更场景,自动生成依赖关系和检查清单,而非简单的任务列表。
注意事项
不适合单文件修复、拼写错误、纯研究/审计/报告产出类工作,以及不需要结构化计划的简单任务。
常见问题
如何安装 ia-planning?
可以通过 npm 全局安装:npm install -g ia-planning,然后在项目目录运行 ia-planning init 初始化 .plan/ 目录。
是否支持多人协作?
支持。.plan/ 目录可纳入版本控制,团队成员可以同步查看和更新计划,AI 会自动合并状态。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/ia-planning-x-2/raw/index.md 读取 ia-planning 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/ia-planning-x-2/raw/index.md(查看排版版本)