ia-planning
基于文件持久化的软件实现规划工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ia-planning。 它的用途是：基于文件持久化的软件实现规划工具 完整的 Skill 内容见：https://321skill.com/skills/ia-planning-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我需要重构用户权限系统，涉及用户表、角色表、权限检查中间件和前端路由守卫四个文件，请帮我制定详细的实现规划。' 它会调用ia-planning在项目目录下创建 .plan/permission-refactor-20250321.md，包含步骤拆解、文件依赖关系图、风险点提示和测试清单。之后你可以随时要求AI按规划推进，或修改规划内容。
介绍
解决什么问题
在涉及多个文件（3个以上）或范围不明确的代码变更时，开发者常常面临步骤遗漏、依赖混乱、结果不可追溯的问题。ia-planning 提供了一种轻量级的规划范式：通过在项目内创建 .plan/ 目录，以文件形式持久化每一步变更计划，确保每次修改都有清晰的路线图、依赖关系和预期产出，避免因信息丢失而导致的返工或遗漏。
怎么用
当您准备进行一项跨文件、有结构性的代码修改时，直接对AI说：“我想为电商系统添加优惠券功能，涉及商品模型、订单计算、优惠券核销三个模块，请帮我规划实现步骤。”AI会调用 ia-planning 在项目根目录生成 .plan/ 文件夹，内部按时间戳或任务名创建计划文件，包含任务分解、文件依赖、变更顺序、测试要点等。您可以在开发过程中随时参考或更新该计划，甚至将其纳入版本控制，实现“规划即文档”。
适合谁
- 项目经理 / 技术负责人：需要确保大范围变更有序推进，可拆分任务并跟踪进度。
- 全栈开发 / 后端开发：负责涉及数据库、API、前端联调等多文件修改，需要系统性规划。
- 智能体开发 / 架构师：在重构或引入新功能时，需要全局视角和可追溯的决策记录。
使用建议或注意事项
- 建议在每次提交代码前，更新
.plan/文件以反映实际变更，保持规划与代码同步。 - 对于单文件修复、打字错误或仅生成报告的研究工作，请跳过此工具，避免不必要的规划开销。
- 如果团队协作，可将
.plan/提交到仓库，让代码评审者也了解变更意图。
核心特点
与同类规划工具（如任务看板、设计文档模板）不同，ia-planning 将规划直接嵌入项目目录，采用纯文本文件持久化，无需额外服务或数据库，且天然支持 Git 版本控制，实现“规划即代码、代码即文档”。
注意事项
不适合单文件修改、简单拼写错误修复、以及仅生成报告而不产出代码的研究/扫描/审计工作。
常见问题
如何开始一个规划？
对AI描述你的变更需求，包含涉及的文件清单和预期目标，AI会自动调用ia-planning生成.plan/目录和计划文件。
规划文件可以多人协作编辑吗？
可以，.plan/是纯文本文件，支持Git合并，建议团队约定格式，避免冲突。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ia-planning-x-4/raw/index.md 读取 ia-planning 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ia-planning-x-4/raw/index.md（查看排版版本）