mstack

Mstack

选择匹配的操作手册并简要说明其名称。操作手册定义流程；原则用于指导决策。仅在需要时加载支持文件，并从其所在文件解析相对链接。

在清单中跟踪操作手册的完成条件。如果没有合适的操作手册，则定义包含明确交付成果和停止条件的任务专属清单。

如需委派或独立审查，请阅读 编排。

如果显式调用 @mstack 时无法加载此条目，请如实说明，不要用其他技能替代。

操作手册

请求	操作指南
新增或更改行为	功能
修复已报告的缺陷	Bug 修复
保持行为不变的重构	重构
新提案、草案或规范	规划
完善现有提案	规范完善
实施规范	规范实施
只读调查代码或架构	调查
原型或视觉一致性工作	原型
性能测量、修复或爬坡优化	性能
诊断线上症状或已捕获的跟踪记录	取证
独立评审或影响范围分析	评审
架构、竞争方案或分区探索	探索
发布、改写、分类处理、修复反馈、检查检查项或监控	PR 工作流
变基 PR，或整理已合并的分支和工作树	PR 工作流
明确指定的堆叠或合并	高级交付
长时间活跃会话任务或项目规模的运行	自主运行
保留或审计可供评审的决策记录	决策记录
继续先前的工作	接手
移交或暂停工作	暂停
创建项目验证技能	创建
维护项目验证技能	维护
通过提问对提案进行压力测试	刨根问底
澄清领域术语或记录术语表／决策	领域建模
用图表或代码结构草图进行说明	展示给我
用 HTML 和大型视觉元素、少量文字进行说明	大图少字
以共同导览的方式带读者了解变更或数据模型	导览
在不更改代码的情况下评估复杂度	展示复杂度
回顾近期工作和实时状态	回顾
复盘当前会话，提炼技能经验	反思
总结当前对话中的进展	跟进
清理限定范围内的变更（代码、文字、注释）	代码清理
改进文字	文字清理
评审注释的价值	注释
查找、应用或调查项目编码标准	编码标准
将项目代码经验整理为规则或检查项	记录经验
说明 mstack 的用法或依赖	帮助

调查

明确问题及其所影响的决策。除非用户另行要求创建产物或进行实现，否则保持只读。

• 运行时机制和所有权：使用 how。
• 设计依据和历史约束：使用 why。
• 在设计选项之间做选择：使用 Architecture，而非 Why。
• 时间趋势、运行缓慢的测试和基准测试：使用 performance，在实现获批前保持只读。
• 教学对话：使用 teach。
• 本质复杂性与偶然复杂性：使用 show-complexity。

追踪关键路径，检查重要的失败情况，并引用实际源码。在有帮助时，委派独立的深入证据收集。问题得到有依据的答案，或明确无法获得决定性事实后，即可停止。只有调查结果支持下一步行动时，才提出建议；调查不会自动转为原型、重构或 PR。

共享规则

• 范围： Mstack 适用于当前调用的任务。选定的 playbook 定义其工作内容和停止条件；阅读其他文件只提供指导，并不授权启动其他工作流。明确的用户指示和仓库规则决定任务要求。保留无关工作和选定的交付分支。PR 已合并或关闭的分支不再是交付分支。
• 审批： 实现（包括编写代码的实验）必须获得已批准的草案或规范。重用已达成一致的草案、规范或反馈修复；新证据实质性改变结果时，需重新征求批准。只读调查、用户要求的规划和差异检查无需实现审批。实验必须放在隔离且明确可弃用的目标中。编写代码前，查找并应用项目标准。
• 交付： 获批的编码工作从已准备好的工作区开始。获批的编码 playbook 授权进行限定范围的提交、推送、创建一个 PR，以及修复必需的 CI。常规交付在合并前停止。代码栈和合并都需要明确请求。
• 完成： 完成情况的声明必须依据针对请求结果的实际证据；实现和审查请使用验证。报告未满足的要求，以及无法执行或未运行的检查。遇到阻碍时，应保留可恢复的状态并寻求帮助，而不是更改目标或悄然降低要求。

原则

在任务范围内应用相关原则前，请先阅读。对于实质性影响了决策的每项原则，请注明其名称和链接，并说明它如何改变了选择。

决策事项	阅读
核心数据、状态、签名或所有权	建模领域
验证、错误、框架或网络适配器	边界规范
重构、抽象、删除或读者负担	减少读者负担
集成需求或重复失败的修复	质疑前提
用户可见行为和产品权衡	体验优先
具有重大不确定性的新颖设计	探索替代方案
宣布任务完成	证明其有效
设计或评估测试	测试行为
基准测试、性能声明或评估分数	说明数字含义
多步骤工作、提交、迁移或技术栈	可验证的单元
并行编写者或共享可变状态	分离所有权
大量证据、探索或交接	保护上下文
可重试命令和部分失败	幂等操作
反复出现的错误或重复的手动工作	固化经验

工具

对于影响重大的决策，请使用 question，提供建议和有意义的替代方案；如果无法使用，则改用对话。请自行查找事实，不要要求用户提供。

通过可用目录发现延迟加载的工具，不要猜测工具名称。

如果用户要求审阅制品，请使用可用的 Plannotator 工具。