用途:把小型或中型技术请求转化为明确的实现计划,供后续 ai-execute-plan 读取并安全实现。计划偏技术,重点写清 HOW,同时保留必要的 WHAT 与 WHY。
主要能力与流程:先探索项目、再做技术澄清、随后生成计划。必须先用 git rev-parse --show-toplevel 解析项目根目录,项目名取 basename;若非 git 仓库,则基于 $PWD 生成 kebab-case 名称并让用户确认。计划路径为 engineering/<project>/workplans/<plan>/plan.md,<plan> 由请求自动生成简短的 kebab-case 标识。计划严格遵循 references/plan-template.md 模板,不得偏离;相关链接块引用 [[engineering/<project>/workplans/<plan>/index|<plan>]]。
输出位置:所有输出写入用户 Obsidian vault,直接写本地文件系统,不使用 MCP。vault 根为 $OBSIDIAN_AI_VAULT,未设置时默认为 $HOME/Documents/obsidian/obsidian。写入后需维护索引:plan 的 index.md、project 的 index.md、engineering/index.md,按 append-if-missing 添加对应 wikilink,避免重复。提交交给 ai-commit 技能,提交信息为 ai-create-plan: <plan>;不要直接运行 git add / git commit / git push,推送失败或未暂存仅简要报告。
限制:必须先分析仓库再提问,未澄清不得生成计划;不得偏离模板;优先复用现有库、模式与项目约定而非自定义开发。若 ai-commit 报告无暂存、无 origin 或推送失败,不得中止技能。执行时需将 Plan ID 交到新会话,运行 ai-execute-plan。