用途:该技能消费现状(as-is)产物(架构视图与变更影响分析)与用户陈述的目标,产出两样东西:可评审的目标态设计(ADR 加一份简洁设计文档,且以现状证据为依据),以及实施编排计划,即机器可读的任务台账,拆分为小而独立、可单独验收的子任务,并声明依赖关系与拓扑顺序。计划是产物而非执行器:任何编排器都可驱动它,本技能不会执行实现,也不依赖特定编码智能体运行时。
触发条件:当用户要求设计目标态、规划工作、拆解任务,或为目标 X 产出实施计划,及其明显等价说法时激活。无关请求不激活,也不会执行产出的计划。
前置条件:需要现状产物(架构视图、变更影响分析)与明确目标。若缺失现状,先指引用户使用现状架构技能,不要基于无据的当前系统图景做设计。
主要能力与产出:ADR 位于 .reposkillopt/decisions/ADR-NNN-<slug>.md,每份一个决策,含上下文、至少两个选项及利弊、决策与后果,目标与现状约束冲突时记为 ADR 权衡而非掩盖;设计文档位于 .reposkillopt/design/design-doc.md,含目标、目标态概览、如何映射到现状(每处变更关联当前组件或流程并引用)、风险与权衡(链接 ADR)、不在范围内;任务台账位于 .reposkillopt/plan/task-ledger.md,以 id|goal|acceptance|depends_on 表格呈现,依赖图无环,front-matter 的 topological_order 列出全部 id 且依赖先于被依赖者。
使用方式:按 (a) 读现状产物与目标,识别约束与影响范围;(b) 写 ADR;(c) 写设计文档;(d) 写任务台账;(e) 通过确定性检查(check_adr、check_task_ledger),要求每个 ADR 至少两个选项、每个任务有目标与验收、依赖存在、图无环、拓扑顺序有效。
限制:不执行实施;需要先有现状证据;设计断言需可追溯到现状证据,推断标为 [inference],未知标为 [unknown]。人工反馈记为 Feedback Items 存于 .reposkillopt/feedback/ 并就地应用;反复出现的通用候选反馈(≥3 条相关)经验证门后才升级为技能编辑提案,不会静默提升。