用途：产出单一、以读者为先的技术方案文档，把架构设计与执行契约合而为一；适用于方案与 RFC，而非通用报告格式。若方案要约束实现方，可另行加载 writing-agent-rules；若需决定方案在更大文档体系中的位置，可另行加载 writing-technical-documentation。
模式：Create（起草新正式文档）、Revise（在保留未受影响细节的前提下修补现有文档）、Lossless structural remap（在保留全部信息单元与交叉引用的情况下重组源文档）、Review（只诊断不改动）、Clean-room handoff（仅在用户明确要求独立工作时准备中立简报）。统一使用 assets/technical-plan.md 作为唯一格式，不把架构与实现拆成两份文档。
流程：先确认受众、目标产物、正式存放位置与决策权限；再读取适用的 AGENTS.md、CLAUDE.md、README、架构文档、规范、源码、测试与已安装依赖，从一手材料核实关键结论，区分事实、决策、假设与未知；将相关主题分为 Locked、Bounded、Open、Assumption 四类。先写约 400 词内的一页决策简报（决策导向标题、副标题、单句 TL;DR、三条要点、目标与非目标、优先级、架构一览图），再接目录，主体按读者依赖顺序排列：背景与约束、原则与优先级、选定架构、组件契约与全生命周期、接口与数据与状态归属、失败行为与横切属性、智能体执行契约与目标构建图、实现顺序与验证、上线与回滚与运营与风险与开放问题、附录。主体保持结论导向，详细权衡分析放附录。
让文档对实现方决策完备：锁定决策与不变量、语言与运行时与框架与持久化等版本约束、组件归属与唯一写入方、目标包与模块与文件与依赖方向、允许的实现自由度、未明确处的优先级规则、关键契约与错误语义、正常与失败生命周期、停止并上报条件、证明架构不变量的测试、上线与回滚触发条件，并保持从架构决策到组件契约、构建步骤、不变量测试与上线后果的可追溯性。
图表：当设计涉及多组件、多身份、多写入方、状态迁移、并发、部署边界或故障窗口时，先画正常生命周期，再画对抗性交错；每张图只保持一个抽象层级。
文风：正式设计用现在时、自包含语言；迁移时序放在专门章节，决策历史放附录。
校验：运行 node <skill-directory>/scripts/lint-plan.mjs <document.md>，错误视为阻塞，警告需解决或说明不适用；同时检查图表渲染、内部链接与本地路径、图文一致、术语与标识一致。无损重构需先读 references/lossless-remapping.md 并建立清单，另运行 node <skill-directory>/scripts/audit-remap.mjs inventory <source.md> <manifest.json> 与 node <skill-directory>/scripts/audit-remap.mjs check <source.md> <target.md> <manifest.json> <report.json>，守恒错误为阻塞项。
限制：深度按后果缩放，短文档用于有界可逆工作，不得为凑模板编造内容；长方案的证据附录可拆到 <plan>.appendix-<topic>.md 并带反向链接，但不得拆分架构与实现；自动无损认证只允许精确搬移加增量材料，任何语义改写、合并、删除或改图均属需人工复核的例外。收费、价格、平台与具体效果资料暂未提供。