SuperAPI AI 工具集

principles

智能体与模型

查看项目

更新于 10-28 16:16

技能介绍

principles 是一个共享的 Pstack 原则技能,用于在调用它的工作流内部选择并应用已有的原则。它不激活 /pstack-mode,也不启动另一个协调器;每个 /principle-* 技能自行负责其适用性和规则。

用途 该技能用于在设计访谈、规格编写、工单规划、实现、测试和评审等阶段,根据当前工作实际选择并应用已安装的 /principle-* 原则。它本身不定义新的原则,而是发现、选择并应用已有的原则所有者。

主要能力

  1. 确定阶段:识别调用方当前所处阶段、已接受的范围、已有产物、已批准接口和操作授权。对于独立调用,则从请求中建立同样的简要说明。当要产出或评估的产物及其完成边界明确时,此步骤完成。
  2. 选择所有者:通过宿主的技能索引发现完整的已安装 /principle-* 清单。如果索引不完整,则枚举已配置的技能根目录,并在选择前解决重复安装。根据当前阶段的实际工作评估每个所有者的描述,包括即将开始的工作。在规划中,纳入正在提议的实现;在评审中,纳入正在评估的变更。完整阅读每个匹配的技能,并将其规则应用到当前产物。使用描述作为选择规则,包括新添加的原则;此处不保留第二套触发目录。仅在已加载所有者的指令和适用性仍然有效时复用。缺失的依赖是命名的覆盖缺口,绝不是已应用的原则。当每个发现的所有者都已被考虑,且每个适用的所有者都已被阅读,或其缺失已被报告时,此步骤完成。
  3. 在调用契约内应用:使用选定的所有者来改变具体的设计、代码、测试或评审决策。保持以下组合边界:用户已接受的需求、仓库约束和操作授权对工作具有约束力。原则不授权更大的功能、替换规格、外部发布或后续工作流阶段。访谈使用原则来锐化建议和未决问题;其确认检查点仍然保留。规格编写综合已确定的决策,并将未解决的冲突记录为阻塞项。工单规划将所需的准备和迁移门放入现有图中。实现遵循已接受的决策,并通过调用方的决策门提出实质性契约变更。后续阶段的需求成为当前产物中的约束或证据要求。区分计划中的检查和工具与已完成的实现和观察到的证据。评审评估当前产物而不编辑它。当 /code-review 是调用方时,将发现路由给它;保留其独立的 Standards 和 Spec 轴。当分支适用时,通过 /principle-migrate-callers-then-delete-legacy-apis 解决迁移策略,通过 /principle-test-behavior-not-implementation 解决测试质量。调用工作流保留其生命周期,包括 /tdd 的红/绿机制和 /code-review 的评估。返回该工作流,而不是递归调用它。当每条选定规则都有具体应用、有证据支持的不适用决定或明确未解决的冲突时,此步骤完成。
  4. 携带决策:在现有规格、工单或执行证据中记录已接受的决策和所需证明。在现有编辑授权内通过 /domain-modeling 协调领域变更。为每个角色保留一个规范产物。对于委托的实现或评审,在简要说明中传递当前阶段、选定的所有者名称、已解决的指令路径或内容、已接受的决策和证据要求。要求工作者在其工作揭示新的适用分支时再次调用 /principles。子级发现或继承的父级上下文不能证明工作者收到了规则。当每个受影响的工作者和产物都携带适用的决策和检查时,此步骤完成。
  5. 完成前重新检查:当阶段、约束或观察到的失败发生变化时,以及在宣布阶段完成之前,重复选择。通过选定的所有者验证实际的阶段产物。完成要求每条适用规则都得到满足,或针对该产物报告为缺口。仅当原则改变了具体选择时才报告原则;省略已加载技能的仪式性列表。

使用方式 该技能在调用工作流内部使用。调用方提供当前阶段、已接受的范围、已有产物、已批准接口和操作授权。技能通过宿主技能索引发现 /principle-* 所有者,评估其描述,完整阅读匹配项,并将规则应用到当前产物。对于委托的实现或评审,调用方需在简要说明中传递当前阶段、选定的所有者名称、已解决的指令路径或内容、已接受的决策和证据要求。

适用场景 适用于设计访谈、规格编写、工单规划、实现、测试和评审等阶段,帮助在这些阶段中一致地选择和应用已有的 Pstack 原则。

限制 该技能不激活 /pstack-mode,也不启动新的协调器。原则不授权更大的功能、替换规格、外部发布或后续工作流阶段。评审评估当前产物而不编辑它。缺失的依赖是覆盖缺口,不是已应用的原则。子级发现或继承的父级上下文不能证明工作者收到了规则。