工程哲学
根据当前任务选择所需的学科。此技能是一个路由指南,而非通用清单。 即使多个学科同时适用,也应保持职责分离。
权限与范围
活动代理和任务定义了权限、范围、Git策略、委托和输出格式。 本技能及其引用均不扩展该权限。
阅读实现指南并不授权编辑、测试、提交或发布。 只读审查保持只读。研究或编写任务不会变成实现任务。 在采用风格默认值之前,先应用项目合同。这些原则不授权无关的工作。
选择并阅读参考
- 确定当前活动和受影响的行为。
- 包含活动代理明确要求的参考。
- 当条件适用时,从下表中选择额外的参考。
- 在相应工作开始前阅读每个选定的参考。不要仅仅将其列为已加载。
- 如果任务发生变化,重新考虑选择。如果参考内容未变,则重复使用已读过的参考。
以下所有路径均相对于 engineering-philosophy 技能目录。
生成的指令副本不会改变该基础目录。
这些是参考文件,而非可独立加载的技能。
必要时加载多个参考,但不要自动加载全部七个。 一个参考可以链接到另一个学科,而无需为每个任务都要求该学科。 仅在需要其指导时阅读链接的参考,而不是仅仅因为存在链接就阅读。
工作的执行方式
| 学科 | 何时阅读 | 参考 |
|---|---|---|
| 实现 | 实现或验证软件变更,包括配置和代理指令。 | 实现 |
| 审查 | 审查代码、补丁、文件或先前的发现。 | 审查 |
| 研究 | 解决外部事实、API行为、兼容性或技术选择。 | 研究 |
| 编写 | 编写或修订持久性技术文档或面向代理的指令。 | 编写 |
结果应满足的标准
| 学科 | 何时阅读 | 参考 |
|---|---|---|
| 代码 | 实现或检查逻辑、转换、验证、状态转换或错误路径。 | 代码 |
| 架构 | 设计或检查边界、所有权、依赖关系、接口或跨组件影响。 | 架构 |
| 前端 | 设计或检查UI、样式、可访问性、交互或响应行为。 | 前端 |
活动和结果学科可以组合。例如,UI实现可能需要实现、代码和前端。 代码审查使用审查和相关结果学科,而不继承实现职责。 仅限文档的任务可以使用编写,而无需加载代码或前端。
所有权与报告
每个参考拥有其学科的所有权。不要将其规则复制到本入口点或代理定义中。
code-review 仍然是审查程序、严重性阈值、裁决和报告格式的独立所有者。
asd-ste100 保持独立,并拥有其适用的受控语言规则。
仅使用实际已读参考中的相关原则。不要默认生成七学科合规报告。 遵循活动代理的报告格式。区分观察到的证据、提供的结果和未经核实的假设。 如果所需参考不可用,请说明并解释由此产生的限制。不要声称应用了未读过的指导。