用途
planning-code-goal 是一个以代码为中心、面向目标的行动规划（Goal-Oriented Action Planning，GOAP）技能，集成了 SPARC 方法论。它面向软件开发目标，帮助将模糊的开发意图转化为具有可度量结果的分阶段计划。典型用途包括：功能实现规划、性能优化目标、测试策略开发、API 开发、数据库演进以及技术债削减。
主要能力
该技能围绕 SPARC 的五个阶段组织规划：
- Specification（规格说明）：定义目标状态，产出需求与验收标准。
- Pseudocode（伪代码）：规划动作序列，产出算法与状态转换。
- Architecture（架构）：结构化解决方案，产出组件与接口。
- Refinement（精化）：以 TDD 方式迭代，产出测试与实现。
- Completion（完成）：验证目标，产出部署与指标。
它支持定义当前代码状态与目标状态，例如测试覆盖率、性能评分、技术债小时数、已完成功能与未解决缺陷等。通过里程碑定义（CodeMilestone 接口）描述每个里程碑所属的 SPARC 阶段、前置条件、交付物、成功标准、预估工时与依赖关系。
技能还提供实现模式示例，如 SPARCGoalPlanner 类中的 achieveGoal 方法按五个阶段依次执行，以及 findOptimalPath 方法使用 A* 搜索在可用 SPARC 动作中寻找从当前状态到目标状态的最优路径。
配置方面，可设置各阶段超时时间、指标目标（如测试覆盖率目标、性能目标、最大技术债小时数）以及风险评估权重（技术、时间线、质量、安全）。
使用方式
使用流程通常包括：分析当前代码状态（覆盖率、性能、技术债）；定义具有可度量标准的目标状态；将目标映射到 SPARC 阶段；为每个阶段生成 GOAP 里程碑；估算工作量与依赖；执行各阶段的 SPARC 命令；全程跟踪指标；用成功标准验证目标达成；记录可复用的模式。
资料中给出了多个使用示例，包括功能实现计划（如支付处理）、性能优化目标（如将 API 延迟降低 50%）、测试策略目标（如达到 80% 覆盖率）。每个示例展示了如何按 SPARC 阶段组织交付物、成功标准与里程碑。
技能还包含执行检查清单、最佳实践（如目标可度量、阶段对齐、TDD 集成、增量进展、风险评估、模式学习）以及错误处理示例（目标不可行时建议可实现的子集并识别阻塞约束；阶段失败时识别具体失败项并重试或重新规划）。
适用场景
- 需要系统化分解的功能实现。
- 具有可度量目标的性能优化。
- 带覆盖率目标的测试策略开发。
- 具有明确契约定义的 API 开发。
- 带迁移规划的数据库演进。
- 带增量里程碑的技术债削减。
限制
使用该技能的前提包括：理解 SPARC 方法论各阶段、清晰定义期望结果、可访问代码库以进行状态分析、具备可度量的成功标准。资料中未提供关于收费、价格、平台支持范围或具体效果保证的信息。