SuperAPI AI 工具集

pstack-principles

编程与开发

查看项目

更新于 10-28 17:14

技能介绍

用途 该技能用于在具体工作流程内部选择并应用 Pstack 原则,适用于设计访谈、规格说明撰写、工单规划、实施、测试与评审等阶段。它本身不激活 /pstack-mode,也不启动另一套协调器;每个 /pstack-principle-* 技能各自负责其适用性与规则。

主要能力

  1. 确定阶段:识别调用方当前阶段、已接受范围、现有产物、已批准接口与操作授权;独立调用时则根据请求建立同样的简要说明。完成条件是待产出或待评估的产物及其完成边界明确。
  2. 选择所有者:通过宿主的技能索引发现完整的已安装 /pstack-principle-* 清单;若索引不完整,则枚举配置的技能根目录并解决重复安装。对每个所有者的描述结合本阶段实际工作进行评估(规划时含拟议的实施,评审时含待评估的改动),完整阅读所有匹配技能并将其规则应用到当前产物。已加载的所有者仅在其指令与适用性仍然有效时复用;缺失依赖应记为覆盖缺口,而非已应用原则。
  3. 在调用契约内应用:用所选所有者改变具体的设计、代码、测试或评审决策。用户已接受的需求、仓库约束与操作授权构成工作边界;原则不授权扩大功能、替换规格、对外发布或推进到后续工作流阶段。访谈用原则强化建议与未决问题,确认检查点保留;规格撰写综合已定决策并将未决冲突记为阻塞项;工单规划在既有图中加入必要准备与迁移关卡;实施遵循已接受决策,实质性契约变更通过调用方的决策关卡提出。后续阶段的要求转化为当前产物的约束或证据要求;区分计划中的检查/工具与已完成的实施/观测证据。评审只评估当前产物而不编辑,发现通过 /code-review 路由(当其为调用方时),并保留其独立的 Standards 与 Spec 两个维度。迁移策略通过 /pstack-principle-migrate-callers-then-delete-legacy-apis 解决,测试质量通过 /pstack-principle-test-behavior-not-implementation 解决(当其分支适用时);调用工作流保留自身生命周期(包括 /tdd 的红绿机制与 /code-review 的评估),应返回该工作流而非递归调用。
  4. 传递决策:在现有规格、工单或执行证据中记录已接受决策与所需证据;通过 /domain-modeling 在现有编辑授权内协调领域变更,每个角色保留一份权威产物。委托实施或评审时,在简要说明中传递当前阶段、所选所有者名称、已解析的指令路径或内容、已接受决策与证据要求;要求工作者在其工作揭示新的适用分支时再次调用 /pstack-principles。子级发现或继承的父级上下文不能证明工作者已收到规则。
  5. 完成前复查:当阶段、约束或观测到的失败发生变化时,以及声明阶段完成前,重复选择。通过所选所有者验证实际阶段产物;完成要求每条适用规则在该产物上得到满足或报告为缺口。仅当原则改变了具体选择时才报告原则,省略加载技能的仪式性清单。

使用方式 在调用方工作流内使用:先确定阶段与产物,再依据已安装原则技能的描述进行选择并完整阅读匹配项,最后将规则落实为具体决策并在产物中记录证据。缺失的依赖应报告为覆盖缺口。

适用场景 设计访谈、规格撰写、工单规划、实施、测试与评审等需要按阶段应用 Pstack 原则的工作。

限制 该技能不激活 /pstack-mode,不启动新协调器;不授权扩大功能、替换规格、对外发布或推进阶段;评审时不编辑产物;无法确定原则所有者时不得臆造。